├── blank.png
├── controls.png
├── default.png
├── style.css
├── edit-tags.js
├── admin.css
├── deprecated.php
├── media-upload-popup.js
├── languages
    └── taxonomy-images.pot
├── code-snippets.php
├── readme.txt
├── readme.md
├── public-filters.php
└── taxonomy-images.php


/blank.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/mfields/Taxonomy-Images/HEAD/blank.png


--------------------------------------------------------------------------------
/controls.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/mfields/Taxonomy-Images/HEAD/controls.png


--------------------------------------------------------------------------------
/default.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/mfields/Taxonomy-Images/HEAD/default.png


--------------------------------------------------------------------------------
/style.css:
--------------------------------------------------------------------------------
 1 | .taxonomy-images-the-terms {
 2 | 	margin: 10px 0;
 3 | 	padding: 0;
 4 | 	zoom: 1;
 5 | }
 6 | .taxonomy-images-the-terms:before,
 7 | .taxonomy-images-the-terms:after {
 8 | 	clear: both;
 9 | 	content: "\0020";
10 | 	display: block;
11 | 	height: 0;
12 | 	visibility: hidden;
13 | }
14 | .taxonomy-images-the-terms li,
15 | .taxonomy-images-the-terms a,
16 | .taxonomy-images-the-terms img {
17 | 	float:left;
18 | 	margin:0;
19 | 	padding:0;
20 | }
21 | .taxonomy-images-the-terms li {
22 | 	list-style-type:none;
23 | 	margin:0 10px 10px 0;
24 | }
25 | 


--------------------------------------------------------------------------------
/edit-tags.js:
--------------------------------------------------------------------------------
 1 | jQuery( document ).ready( function( $ ) {
 2 | 
 3 | 	$( 'body' ).on( 'click', '.taxonomy-image-control a', function () {
 4 | 		taxonomyImagesPlugin.tt_id = parseInt( $( this ).parent().find( 'input.tt_id' ).val() );
 5 | 		taxonomyImagesPlugin.term_name = $( this ).parent().find( 'input.term_name' ).val();
 6 | 		taxonomyImagesPlugin.image_id = parseInt( $( this ).parent().find( 'input.image_id' ).val() );
 7 | 	} );
 8 | 
 9 | 	$( 'body' ).on( 'click', '.taxonomy-image-control .remove', function () {
10 | 		$.ajax( {
11 | 			url: ajaxurl,
12 | 			type: "POST",
13 | 			dataType: 'json',
14 | 			data: {
15 | 				'action'   : 'taxonomy_image_plugin_remove_association',
16 | 				'wp_nonce' : taxonomyImagesPlugin.nonce,
17 | 				'tt_id'    : taxonomyImagesPlugin.tt_id
18 | 				},
19 | 			cache: false,
20 | 			success: function ( response ) {
21 | 				if ( 'good' === response.status ) {
22 | 					$( '#remove-' + taxonomyImagesPlugin.tt_id ).addClass( 'hide' );
23 | 					$( '#taxonomy_image_plugin_' + taxonomyImagesPlugin.tt_id ).attr( 'src', taxonomyImagesPlugin.img_src );
24 | 				}
25 | 				else if ( 'bad' === response.status ) {
26 | 					alert( response.why );
27 | 				}
28 | 			}
29 | 		} );
30 | 		return false;
31 | 	} );
32 | } );
33 | 


--------------------------------------------------------------------------------
/admin.css:
--------------------------------------------------------------------------------
 1 | .taxonomy-images-modal .create-association .term-name {
 2 | 	font-style: italic;
 3 | }
 4 | .taxonomy-images-modal .create-association {
 5 | 	display: inline;
 6 | }
 7 | .taxonomy-images-modal .remove-association {
 8 | 	color: #bc0b0b;
 9 | 	cursor: pointer;
10 | 	display: none;
11 | 	text-decoration: underline;
12 | }
13 | .taxonomy-images-modal #tab-type_url,
14 | .taxonomy-images-modal .savesend input {
15 | 	display: none !important;
16 | }
17 | .taxonomy-image-thumbnail {
18 | 	display: block;
19 | 	margin-bottom: 3px;
20 | 	overflow: hidden;
21 | 	text-align: center;
22 | 	width: 77px;
23 | 	height: 77px;
24 | }
25 | .taxonomy-image-control .control {
26 | 	background: url( controls.png );
27 | 	background-repeat: no-repeat;
28 | 	display: block;
29 | 	float: left;
30 | 	text-indent: -9999em;
31 | 	width: 15px;
32 | 	height: 15px;
33 | }
34 | .taxonomy-image-control .control:hover {
35 | 	cursor: pointer;
36 | }
37 | .taxonomy-image-control .upload {
38 | 	background-position: 0 0;
39 | }
40 | .taxonomy-image-control .upload:hover {
41 | 	background-position: -15px 0;
42 | }
43 | .taxonomy-image-control .remove {
44 | 	background-position: -30px 0;
45 | }
46 | .taxonomy-image-control .remove:hover {
47 | 	background-position: -45px 0;
48 | }
49 | .taxonomy-image-control .library {
50 | 	background-position: -60px 0;
51 | }
52 | .taxonomy-image-control .hide {
53 | 	visibility: hidden;
54 | }
55 | .taxonomy-image-control .show {
56 | 	visibility: visible;
57 | }
58 | 


--------------------------------------------------------------------------------
/deprecated.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /**
  4 |  * Deprecated Shortcode.
  5 |  *
  6 |  * @return    void
  7 |  * @access    private
  8 |  */
  9 | function taxonomy_images_plugin_shortcode_deprecated( $atts = array() ) { // DEPRECATED
 10 | 	$o = '';
 11 | 	$defaults = array(
 12 | 		'taxonomy' => 'category',
 13 | 		'size'     => 'detail',
 14 | 		'template' => 'list'
 15 | 		);
 16 | 
 17 | 	extract( shortcode_atts( $defaults, $atts ) );
 18 | 
 19 | 	/* No taxonomy defined return an html comment. */
 20 | 	if ( ! taxonomy_exists( $taxonomy ) ) {
 21 | 		$tax = strip_tags( trim( $taxonomy ) );
 22 | 		return '<!-- taxonomy_image_plugin error: Taxonomy "' . $taxonomy . '" is not defined.-->';
 23 | 	}
 24 | 
 25 | 	$terms = get_terms( $taxonomy );
 26 | 	$associations = taxonomy_image_plugin_get_associations( $refresh = false );
 27 | 
 28 | 	if ( ! is_wp_error( $terms ) ) {
 29 | 		foreach( (array) $terms as $term ) {
 30 | 			$url         = get_term_link( $term, $term->taxonomy );
 31 | 			$title       = apply_filters( 'the_title', $term->name );
 32 | 			$title_attr  = esc_attr( $term->name . ' (' . $term->count . ')' );
 33 | 			$description = apply_filters( 'the_content', $term->description );
 34 | 
 35 | 			$img = '';
 36 | 			if ( array_key_exists( $term->term_taxonomy_id, $associations ) ) {
 37 | 				$img = wp_get_attachment_image( $associations[$term->term_taxonomy_id], 'detail', false );
 38 | 			}
 39 | 
 40 | 			if( $template === 'grid' ) {
 41 | 				$o.= "\n\t" . '<div class="taxonomy_image_plugin-' . $template . '">';
 42 | 				$o.= "\n\t\t" . '<a style="float:left;" title="' . $title_attr . '" href="' . $url . '">' . $img . '</a>';
 43 | 				$o.= "\n\t" . '</div>';
 44 | 			}
 45 | 			else {
 46 | 				$o.= "\n\t\t" . '<a title="' . $title_attr . '" href="' . $url . '">' . $img . '</a>';;
 47 | 				$o.= "\n\t\t" . '<h2 style="clear:none;margin-top:0;padding-top:0;line-height:1em;"><a href="' . $url . '">' . $title . '</a></h2>';
 48 | 				$o.= $description;
 49 | 				$o.= "\n\t" . '<div style="clear:both;height:1.5em"></div>';
 50 | 				$o.= "\n";
 51 | 			}
 52 | 		}
 53 | 	}
 54 | 	return $o;
 55 | }
 56 | add_shortcode( 'taxonomy_image_plugin', 'taxonomy_images_plugin_shortcode_deprecated' );
 57 | 
 58 | 
 59 | /**
 60 |  * This class has been left for backward compatibility with versions
 61 |  * of this plugin 0.5 and under. Please do not use any methods or
 62 |  * properties directly in your theme.
 63 |  *
 64 |  * @access     private        This class is deprecated. Do not use!!!
 65 |  */
 66 | class taxonomy_images_plugin {
 67 | 	public $settings = array();
 68 | 	public function __construct() {
 69 | 		$this->settings = taxonomy_image_plugin_get_associations();
 70 | 		add_action( 'taxonomy_image_plugin_print_image_html', array( &$this, 'print_image_html' ), 1, 3 );
 71 | 	}
 72 | 	public function get_thumb( $id ) {
 73 | 		return taxonomy_image_plugin_get_image_src( $id );
 74 | 	}
 75 | 	public function print_image_html( $size = 'medium', $term_tax_id = false, $title = true, $align = 'none' ) {
 76 | 		print $this->get_image_html( $size, $term_tax_id, $title, $align );
 77 | 	}
 78 | 	public function get_image_html( $size = 'medium', $term_tax_id = false, $title = true, $align = 'none' ) {
 79 | 		$o = '';
 80 | 		if ( false === $term_tax_id ) {
 81 | 			global $wp_query;
 82 | 			$obj = $wp_query->get_queried_object();
 83 | 			if ( isset( $obj->term_taxonomy_id ) ) {
 84 | 				$term_tax_id = $obj->term_taxonomy_id;
 85 | 			}
 86 | 			else {
 87 | 				return false;
 88 | 			}
 89 | 		}
 90 | 		$term_tax_id = (int) $term_tax_id;
 91 | 		if ( isset( $this->settings[ $term_tax_id ] ) ) {
 92 | 			$attachment_id = (int) $this->settings[ $term_tax_id ];
 93 | 			$alt           = get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
 94 | 			$attachment    = get_post( $attachment_id );
 95 | 			/* Just in case an attachment was deleted, but there is still a record for it in this plugins settings. */
 96 | 			if ( $attachment !== NULL ) {
 97 | 				$o = get_image_tag( $attachment_id, $alt, '', $align, $size );
 98 | 			}
 99 | 		}
100 | 		return $o;
101 | 	}
102 | }
103 | $taxonomy_images_plugin = new taxonomy_images_plugin();
104 | 


--------------------------------------------------------------------------------
/media-upload-popup.js:
--------------------------------------------------------------------------------
  1 | var TaxonomyImagesCreateAssociation;
  2 | 
  3 | jQuery( document ).ready( function( $ ) {
  4 | 	var ID = 0, below;
  5 | 
  6 | 	/* Get window that opened the thickbox. */
  7 | 	below = window.dialogArguments || opener || parent || top;
  8 | 
  9 | 	if ( null !== below && 'taxonomyImagesPlugin' in below ) {
 10 | 		/* Set the value of ID. */
 11 | 		if ( 'tt_id' in below.taxonomyImagesPlugin ) {
 12 | 			ID = parseInt( below.taxonomyImagesPlugin.tt_id );
 13 | 			if ( isNaN( ID ) ) {
 14 | 				ID = 0;
 15 | 			}
 16 | 		}
 17 | 		/* Replace term name. */
 18 | 		if ( 'term_name' in below.taxonomyImagesPlugin ) {
 19 | 			$( '.create-association .term-name' ).html( TaxonomyImagesModal.termBefore + below.taxonomyImagesPlugin.term_name + TaxonomyImagesModal.termAfter );
 20 | 		}
 21 | 	}
 22 | 
 23 | 	if ( 0 < ID ) {
 24 | 		$( 'body' ).addClass( 'taxonomy-images-modal' );
 25 | 
 26 | 		var buttons = $( '.taxonomy-images-modal .create-association' );
 27 | 
 28 | 		/* Add hidden input to search form. */
 29 | 		$( '#filter' ).prepend( '<input type="hidden" name="taxonomy_images_plugin" value="' + ID + '" />' );
 30 | 
 31 | 		if ( 'image_id' in below.taxonomyImagesPlugin ) {
 32 | 			buttons.each( function( i, e ) {
 33 | 				var image_id = $( e ).parent().find( '.taxonomy-image-button-image-id' ).val();
 34 | 				if ( image_id == below.taxonomyImagesPlugin.image_id ) {
 35 | 					$( e ).hide();
 36 | 					$( e ).parent().find( '.remove-association' ).css( 'display', 'inline' );
 37 | 				}
 38 | 			} );
 39 | 		}
 40 | 	}
 41 | 
 42 | 	$( '.taxonomy-images-modal' ).on( 'click', '.remove-association', function () {
 43 | 		var button = $( this );
 44 | 		originalText = button.html();
 45 | 		button.html( TaxonomyImagesModal.removing );
 46 | 
 47 | 		$.ajax( {
 48 | 			url: ajaxurl,
 49 | 			type: "POST",
 50 | 			dataType: 'json',
 51 | 			data: {
 52 | 				'action'   : 'taxonomy_image_plugin_remove_association',
 53 | 				'wp_nonce' : $( this ).parent().find( '.taxonomy-image-button-nonce-remove' ).val(),
 54 | 				'tt_id'    : ID
 55 | 				},
 56 | 			cache: false,
 57 | 			success: function ( response ) {
 58 | 				if ( 'good' === response.status ) {
 59 | 					button.html( TaxonomyImagesModal.removed ).fadeOut( 200, function() {
 60 | 						$( this ).hide();
 61 | 						var selector = parent.document.getElementById( 'taxonomy_image_plugin_' + ID );
 62 | 						$( selector ).attr( 'src', below.taxonomyImagesPlugin.img_src );
 63 | 						$( this ).parent().find( '.create-association' ).show();
 64 | 						$( this ).html( originalText );
 65 | 					} );
 66 | 				}
 67 | 				else if ( 'bad' === response.status ) {
 68 | 					alert( response.why );
 69 | 				}
 70 | 			}
 71 | 		} );
 72 | 		return false;
 73 | 	} );
 74 | 
 75 | 	$( '.taxonomy-images-modal' ).on( 'click', '.create-association', function () {
 76 | 		var button, selector, originalText;
 77 | 		if ( 0 == ID ) {
 78 | 			return;
 79 | 		}
 80 | 
 81 | 		button = $( this );
 82 | 		originalText = button.html();
 83 | 		button.html( TaxonomyImagesModal.associating );
 84 | 
 85 | 		$.ajax( {
 86 | 			url      : ajaxurl,
 87 | 			type     : "POST",
 88 | 			dataType : 'json',
 89 | 			data: {
 90 | 				'action'        : 'taxonomy_image_create_association',
 91 | 				'wp_nonce'      : $( this ).parent().find( '.taxonomy-image-button-nonce-create' ).val(),
 92 | 				'attachment_id' : $( this ).parent().find( '.taxonomy-image-button-image-id' ).val(),
 93 | 				'tt_id'         : parseInt( ID )
 94 | 				},
 95 | 			success: function ( response ) {
 96 | 				if ( 'good' === response.status ) {
 97 | 					var parent_id = button.parent().attr( 'id' );
 98 | 
 99 | 					/* Set state of all other buttons. */
100 | 					$( '.taxonomy-image-modal-control' ).each( function( i, e ) {
101 | 						if ( parent_id == $( e ).attr( 'id' ) ) {
102 | 							return true;
103 | 						}
104 | 						$( e ).find( '.create-association' ).show();
105 | 						$( e ).find( '.remove-association' ).hide();
106 | 					} );
107 | 
108 | 					selector = parent.document.getElementById( 'taxonomy-image-control-' + ID );
109 | 
110 | 					/* Update the image on the screen below */
111 | 					$( selector ).find( '.taxonomy-image-thumbnail img' ).each( function ( i, e ) {
112 | 						$( e ).attr( 'src', response.attachment_thumb_src );
113 | 					} );
114 | 
115 | 					/* Show delete control on the screen below */
116 | 					$( selector ).find( '.remove' ).each( function ( i, e ) {
117 | 						$( e ).removeClass( 'hide' );
118 | 					} );
119 | 
120 | 					button.show().html( TaxonomyImagesModal.success ).fadeOut( 200, function() {
121 | 						var remove = button.parent().find( '.remove-association' );
122 | 						if ( undefined !== remove[0] ) {
123 | 							$( remove ).css( 'display', 'inline' );
124 | 							button.hide();
125 | 							button.html( originalText );
126 | 						}
127 | 					} );
128 | 				}
129 | 				else if ( 'bad' === response.status ) {
130 | 					alert( response.why );
131 | 				}
132 | 			}
133 | 		} );
134 | 		return false;
135 | 	} );
136 | } );
137 | 


--------------------------------------------------------------------------------
/languages/taxonomy-images.pot:
--------------------------------------------------------------------------------
  1 | # Copyright (C) 2011 Taxonomy Images
  2 | # This file is distributed under the same license as the Taxonomy Images package.
  3 | msgid ""
  4 | msgstr ""
  5 | "Project-Id-Version: Taxonomy Images 0.7.2\n"
  6 | "Report-Msgid-Bugs-To: http://wordpress.org/tag/taxonomy-images\n"
  7 | "POT-Creation-Date: 2011-06-20 17:47:57+00:00\n"
  8 | "MIME-Version: 1.0\n"
  9 | "Content-Type: text/plain; charset=UTF-8\n"
 10 | "Content-Transfer-Encoding: 8bit\n"
 11 | "PO-Revision-Date: 2010-MO-DA HO:MI+ZONE\n"
 12 | "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 13 | "Language-Team: LANGUAGE <LL@li.org>\n"
 14 | 
 15 | #: taxonomy-images.php:125
 16 | msgid "Associate with %1$s"
 17 | msgstr ""
 18 | 
 19 | #: taxonomy-images.php:125 taxonomy-images.php:127
 20 | msgid "this term"
 21 | msgstr ""
 22 | 
 23 | #: taxonomy-images.php:127
 24 | msgid "Remove association with %1$s"
 25 | msgstr ""
 26 | 
 27 | #. translators: Notice displayed on the custom administration page.
 28 | #: taxonomy-images.php:281
 29 | msgid "Image support for taxonomies successfully updated"
 30 | msgstr ""
 31 | 
 32 | #. translators: Notice displayed on the custom administration page.
 33 | #: taxonomy-images.php:284
 34 | msgid "Image support has been disabled for all taxonomies."
 35 | msgstr ""
 36 | 
 37 | #: taxonomy-images.php:324 taxonomy-images.php:1170
 38 | msgid "Settings"
 39 | msgstr ""
 40 | 
 41 | #: taxonomy-images.php:330
 42 | msgid "Taxonomies"
 43 | msgstr ""
 44 | 
 45 | #. #-#-#-#-#  plugin.pot (Taxonomy Images 0.7.2)  #-#-#-#-#
 46 | #. Plugin Name of the plugin/theme
 47 | #: taxonomy-images.php:349 taxonomy-images.php:350
 48 | msgid "Taxonomy Images"
 49 | msgstr ""
 50 | 
 51 | #. translators: Heading of the custom administration page.
 52 | #: taxonomy-images.php:377
 53 | msgid "Taxonomy Images Plugin Settings"
 54 | msgstr ""
 55 | 
 56 | #. translators: Button on the custom administration page.
 57 | #: taxonomy-images.php:385
 58 | msgid "Save Changes"
 59 | msgstr ""
 60 | 
 61 | #. translators: An ajax request has failed for an unknown reason.
 62 | #: taxonomy-images.php:432
 63 | msgid "Unknown error encountered"
 64 | msgstr ""
 65 | 
 66 | #: taxonomy-images.php:507 taxonomy-images.php:589
 67 | msgid "tt_id not sent"
 68 | msgstr ""
 69 | 
 70 | #: taxonomy-images.php:515 taxonomy-images.php:597
 71 | msgid "tt_id is empty"
 72 | msgstr ""
 73 | 
 74 | #: taxonomy-images.php:522 taxonomy-images.php:604
 75 | msgid "You do not have the correct capability to manage this term"
 76 | msgstr ""
 77 | 
 78 | #: taxonomy-images.php:529
 79 | msgid "No nonce included."
 80 | msgstr ""
 81 | 
 82 | #: taxonomy-images.php:536 taxonomy-images.php:618
 83 | msgid "Nonce did not match"
 84 | msgstr ""
 85 | 
 86 | #: taxonomy-images.php:543
 87 | msgid "Image id not sent"
 88 | msgstr ""
 89 | 
 90 | #: taxonomy-images.php:551
 91 | msgid "Image id is not a positive integer"
 92 | msgstr ""
 93 | 
 94 | #: taxonomy-images.php:560
 95 | msgid "Image successfully associated"
 96 | msgstr ""
 97 | 
 98 | #: taxonomy-images.php:567
 99 | msgid "Association could not be created"
100 | msgstr ""
101 | 
102 | #: taxonomy-images.php:611
103 | msgid "No nonce included"
104 | msgstr ""
105 | 
106 | #: taxonomy-images.php:626
107 | msgid "Nothing to remove"
108 | msgstr ""
109 | 
110 | #: taxonomy-images.php:635
111 | msgid "Association successfully removed"
112 | msgstr ""
113 | 
114 | #: taxonomy-images.php:641
115 | msgid "Association could not be removed"
116 | msgstr ""
117 | 
118 | #: taxonomy-images.php:711 taxonomy-images.php:760
119 | msgid "Image"
120 | msgstr ""
121 | 
122 | #: taxonomy-images.php:754 taxonomy-images.php:790
123 | msgid "term"
124 | msgstr ""
125 | 
126 | #: taxonomy-images.php:764
127 | msgid "Associate an image from your media library to this %1$s."
128 | msgstr ""
129 | 
130 | #: taxonomy-images.php:808
131 | msgid "Associate an image with the %1$s named &#8220;%2$s&#8221;."
132 | msgstr ""
133 | 
134 | #: taxonomy-images.php:809
135 | msgid "Upload a new image for this %s."
136 | msgstr ""
137 | 
138 | #: taxonomy-images.php:809
139 | msgid "Upload."
140 | msgstr ""
141 | 
142 | #: taxonomy-images.php:810
143 | msgid "Remove image from this %s."
144 | msgstr ""
145 | 
146 | #: taxonomy-images.php:810
147 | msgid "Delete"
148 | msgstr ""
149 | 
150 | #: taxonomy-images.php:839
151 | msgid "&#8220;"
152 | msgstr ""
153 | 
154 | #: taxonomy-images.php:840
155 | msgid "&#8221;"
156 | msgstr ""
157 | 
158 | #: taxonomy-images.php:841
159 | msgid "Associating &#8230;"
160 | msgstr ""
161 | 
162 | #: taxonomy-images.php:842
163 | msgid "Successfully Associated"
164 | msgstr ""
165 | 
166 | #: taxonomy-images.php:843
167 | msgid "Removing &#8230;"
168 | msgstr ""
169 | 
170 | #: taxonomy-images.php:844
171 | msgid "Successfully Removed"
172 | msgstr ""
173 | 
174 | #: taxonomy-images.php:1098
175 | msgid ""
176 | "The %1$s argument for %2$s is set to %3$s which is not a registered "
177 | "taxonomy. Please check the spelling and update the argument."
178 | msgstr ""
179 | 
180 | #: taxonomy-images.php:1099
181 | msgid "taxonomy"
182 | msgstr ""
183 | 
184 | #: taxonomy-images.php:1109
185 | msgid "No taxonomies have image support. %1$s"
186 | msgstr ""
187 | 
188 | #: taxonomy-images.php:1114
189 | msgid "The %1$s taxonomy does not have image support. %2$s"
190 | msgstr ""
191 | 
192 | #: taxonomy-images.php:1139
193 | msgid "The %1$s has been called directly. Please use the %2$s filter instead."
194 | msgstr ""
195 | 
196 | #: taxonomy-images.php:1175
197 | msgid "Donate"
198 | msgstr ""
199 | 
200 | #: taxonomy-images.php:1193
201 | msgid "Manage Settings"
202 | msgstr ""
203 | 
204 | #: public-filters.php:376
205 | msgid ""
206 | "%1$s is not a property of the current queried object. This usually happens "
207 | "when the %2$s filter is used in an unsupported template file. This filter "
208 | "has been designed to work in taxonomy archives which are traditionally "
209 | "served by one of the following template files: category.php, tag.php or "
210 | "taxonomy.php. Learn more about %3$s."
211 | msgstr ""
212 | 
213 | #: public-filters.php:377
214 | msgid "term_taxonomy_id"
215 | msgstr ""
216 | 
217 | #. Description of the plugin/theme
218 | msgid ""
219 | "Associate images from your media library to categories, tags and custom "
220 | "taxonomies."
221 | msgstr ""
222 | 


--------------------------------------------------------------------------------
/code-snippets.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Tests for various filters.
  4 |  */
  5 | 
  6 | 
  7 | exit;
  8 | 
  9 | 
 10 | 
 11 | /*
 12 |  * Append the term images to content + excerpt.
 13 |  */
 14 | function mytheme_append_the_term_images( $content ) {
 15 | 	return $content . apply_filters( 'taxonomy-images-list-the-terms', '', array(
 16 | 		'image_size' => 'detail',
 17 | 		) );
 18 | }
 19 | add_filter( 'the_content', 'mytheme_append_the_term_images' );
 20 | add_filter( 'the_excerpt', 'mytheme_append_the_term_images' );
 21 | 
 22 | 
 23 | 
 24 | /*
 25 |  * Queried Term Image.
 26 |  *
 27 |  * Return html markup representing the image associated with the
 28 |  * currently queried term. In the event that no associated image
 29 |  * exists, the filter should return an empty object.
 30 |  *
 31 |  * In the event that the Taxonomy Images plugin is not installed
 32 |  * apply_filters() will return it's second parameter.
 33 |  */
 34 | 
 35 | 
 36 | /* Default */
 37 | $img = apply_filters( 'taxonomy-images-queried-term-image', 'PLEASE INSTALL PLUGIN' );
 38 | print '<h2>taxonomy-images-queried-term-image</h2>';
 39 | print '<pre>' . htmlentities( $img ) . '</pre>';
 40 | 
 41 | 
 42 | /* Inside a yellow box */
 43 | $img = apply_filters( 'taxonomy-images-queried-term-image', 'PLEASE INSTALL PLUGIN', array(
 44 | 	'before' => '<div style="padding:20px;background-color:yellow;">',
 45 | 	'after'  => '</div>',
 46 | 	) );
 47 | print '<h2>taxonomy-images-queried-term-image - custom wrapper element.</h2>';
 48 | print '<pre>' . htmlentities( $img ) . '</pre>';
 49 | 
 50 | 
 51 | /* Medium Size */
 52 | $img = apply_filters( 'taxonomy-images-queried-term-image', 'PLEASE INSTALL PLUGIN', array(
 53 | 	'image_size' => 'medium',
 54 | 	) );
 55 | print '<h2>taxonomy-images-queried-term-image - medium image size</h2>';
 56 | print '<pre>' . htmlentities( $img ) . '</pre>';
 57 | 
 58 | 
 59 | /* Unrecognized size */
 60 | $img = apply_filters( 'taxonomy-images-queried-term-image', 'PLEASE INSTALL PLUGIN', array(
 61 | 	'image_size' => 'this-is-probably-not-a-real-image-size',
 62 | 	) );
 63 | print '<h2>taxonomy-images-queried-term-image - unknown image size</h2>';
 64 | print '<pre>' . htmlentities( $img ) . '</pre>';
 65 | 
 66 | 
 67 | /* Custom attributes. */
 68 | $img = apply_filters( 'taxonomy-images-queried-term-image', 'PLEASE INSTALL PLUGIN', array(
 69 | 	'attr' => array(
 70 | 		'alt'   => 'Custom alternative text',
 71 | 		'class' => 'my-class-list bunnies turtles',
 72 | 		'src'   => 'this-is-where-the-image-lives.png',
 73 | 		'title' => 'Custom Title',
 74 | 		),
 75 | 	) );
 76 | print '<h2>taxonomy-images-queried-term-image - custom attributes</h2>';
 77 | print '<pre>' . htmlentities( $img ) . '</pre>';
 78 | 
 79 | 
 80 | 
 81 | /*
 82 |  * Queried Term Image ID.
 83 |  *
 84 |  * Return the id of the image associated with the currently
 85 |  * queried term. In the event that no associated image exists,
 86 |  * the filter should return zero.
 87 |  *
 88 |  * In the event that the Taxonomy Images plugin is not installed
 89 |  * apply_filters() will return it's second parameter.
 90 |  */
 91 | $img = apply_filters( 'taxonomy-images-queried-term-image-id', 'PLEASE INSTALL PLUGIN' );
 92 | 
 93 | print '<h2>taxonomy-images-queried-term-image-id</h2>';
 94 | print '<pre>'; var_dump( $img ); print '</pre>';
 95 | 
 96 | 
 97 | 
 98 | 
 99 | /*
100 |  * Queried Term Image Object.
101 |  *
102 |  * Return an object representing the image associated with the
103 |  * currently queried term. In the event that no associated image
104 |  * exists, the filter should return an empty object.
105 |  *
106 |  * In the event that the Taxonomy Images plugin is not installed
107 |  * apply_filters() will return it's second parameter.
108 |  */
109 | $img = apply_filters( 'taxonomy-images-queried-term-image-object', 'PLEASE INSTALL PLUGIN' );
110 | 
111 | print '<h2>taxonomy-images-queried-term-image-object</h2>';
112 | print '<pre>'; var_dump( $img ); print '</pre>';
113 | 
114 | 
115 | 
116 | 
117 | /*
118 |  * Queried Term Image URL.
119 |  *
120 |  * Return a url to the image associated with the current queried
121 |  * term. In the event that no associated image exists, the filter
122 |  * should return an empty string.
123 |  *
124 |  * In the event that the Taxonomy Images plugin is not installed
125 |  * apply_filters() will return it's second parameter.
126 |  */
127 | 
128 | 
129 | /* Default */
130 | $img = apply_filters( 'taxonomy-images-queried-term-image-url', 'PLEASE INSTALL PLUGIN' );
131 | print '<h2>taxonomy-images-queried-term-image-url - Default</h2>';
132 | print '<pre>'; var_dump( $img ); print '</pre>';
133 | 
134 | 
135 | /* Medium Size */
136 | $img = apply_filters( 'taxonomy-images-queried-term-image-url', 'PLEASE INSTALL PLUGIN', array(
137 | 	'image_size' => 'medium'
138 | 	) );
139 | print '<h2>taxonomy-images-queried-term-image-url - Medium</h2>';
140 | print '<pre>'; var_dump( $img ); print '</pre>';
141 | 
142 | 
143 | /* Unregistered Size */
144 | $img = apply_filters( 'taxonomy-images-queried-term-image-url', 'PLEASE INSTALL PLUGIN', array(
145 | 	'image_size' => 'this-is-not-real-size-probably-I-hope'
146 | 	) );
147 | print '<h2>taxonomy-images-queried-term-image-url - Unregistered</h2>';
148 | print '<pre>'; var_dump( $img ); print '</pre>';
149 | 
150 | 
151 | 
152 | 
153 | /*
154 |  * Queried Term Image Data.
155 |  *
156 |  * Return an array of data about the image associated with the current
157 |  * queried term. In the event that no associated image exists, the filter
158 |  * should return an empty string.
159 |  *
160 |  * In the event that the Taxonomy Images plugin is not installed
161 |  * apply_filters() will return it's second parameter.
162 |  */
163 | 
164 | 
165 | /* Default */
166 | $img = apply_filters( 'taxonomy-images-queried-term-image-data', 'PLEASE INSTALL PLUGIN' );
167 | print '<h2>taxonomy-images-queried-term-image-data - Default</h2>';
168 | print '<pre>'; var_dump( $img ); print '</pre>';
169 | 
170 | 
171 | /* Medium Size */
172 | $img = apply_filters( 'taxonomy-images-queried-term-image-data', 'PLEASE INSTALL PLUGIN', array(
173 | 	'image_size' => 'medium'
174 | 	) );
175 | print '<h2>taxonomy-images-queried-term-image-data - Medium</h2>';
176 | print '<pre>'; var_dump( $img ); print '</pre>';
177 | 
178 | 
179 | /* Unregistered Size */
180 | $img = apply_filters( 'taxonomy-images-queried-term-image-data', 'PLEASE INSTALL PLUGIN', array(
181 | 	'image_size' => 'this-is-not-real-size-probably-I-hope'
182 | 	) );
183 | print '<h2>taxonomy-images-queried-term-image-data - Unregistered</h2>';
184 | print '<pre>'; var_dump( $img ); print '</pre>';
185 | 


--------------------------------------------------------------------------------
/readme.txt:
--------------------------------------------------------------------------------
  1 | ===Taxonomy Images===
  2 | 
  3 | Contributors:         mfields, jamiemchale
  4 | Donate link:          http://wordpress.mfields.org/donate/
  5 | Tags:                 taxonomy, tag, category, image, upload, media
  6 | Requires at least:    3.1
  7 | Tested up to:         3.6
  8 | Stable tag:           trunk
  9 | 
 10 | Associate images from your media library to categories, tags and custom taxonomies.
 11 | 
 12 | ==Description==
 13 | 
 14 | For usage instructions please view the [screencast](http://screenr.com/zMx).
 15 | 
 16 | = Displaying Your Images in Your Theme =
 17 | 
 18 | There are a few filters that you can use in your theme to display the image associations created by this plugin. Please read below for detailed information.
 19 | 
 20 | = Display a single image representing the term archive =
 21 | 
 22 | The following filter will display the image associated with the term asked for in the query string of the url. This filter only works in views that naturally use templates like category.php, tag.php taxonomy.php and all of their derivatives. Please read about [template hierarchy](http://codex.wordpress.org/Template_Hierarchy) for more information about these templates. The simplest use of this filter looks like:
 23 | 
 24 | `print apply_filters( 'taxonomy-images-queried-term-image', '' );`
 25 | 
 26 | This code will generate and print an image tag. It's output can be modifed by passig an optional third parameter to apply filters. This parameter is an array and the following keys may be set:
 27 | 
 28 | * __after__ (string) - Text to append to the image's HTML.
 29 | 
 30 | * __attr__ (array) - Key/value pairs representing the attributes of the img tag. Available options include: alt, class, src and title. This array will be passed as the fourth parameter to WordPress core function wp_get_attachment_image() without modification.
 31 | 
 32 | * __before__ (string) - Text to prepend to the image's HTML.
 33 | 
 34 | * __image_size__ (string) - May be any image size registered with WordPress. If no image size is specified, 'thumbnail' will be used as a default value. In the event that an unregistered size is specified, this filter will return an empty string.
 35 | 
 36 | Here's an example of what a fully customized version of this filter might look like:
 37 | 
 38 | `print apply_filters( 'taxonomy-images-queried-term-image', '', array(
 39 | 	'after' => '</div>'
 40 | 	'attr' => array(
 41 | 		'alt'   => 'Custom alternative text',
 42 | 		'class' => 'my-class-list bunnies turtles',
 43 | 		'src'   => 'this-is-where-the-image-lives.png',
 44 | 		'title' => 'Custom Title',
 45 | 		),
 46 | 	'before' => '<div id="my-custom-div">',
 47 | 	'image_size' => 'medium',
 48 | 	) );
 49 | `
 50 | 
 51 | = Similar functionality =
 52 | 
 53 | If you just need to get the database ID for the image, you may want to use:
 54 | 
 55 | `$image_id = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );`
 56 | 
 57 | If you need to get the full object of the image, you may want to use:
 58 | 
 59 | `$image = apply_filters( 'taxonomy-images-queried-term-image-object', '' );`
 60 | 
 61 | If you need to get the url to the image, you may want to use the following:
 62 | 
 63 | `$image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '' );`
 64 | 
 65 | You can specify the size of the image in an option third parameter:
 66 | 
 67 | `
 68 | $image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '', array(
 69 | 	'image_size' => 'medium'
 70 | 	) );
 71 | `
 72 | 
 73 | If you need data about the image, you may want to use:
 74 | 
 75 | `$image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '' );`
 76 | 
 77 | You can specify the size of the image in an option third parameter:
 78 | 
 79 | `
 80 | $image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '', array(
 81 | 	'image_size' => 'medium'
 82 | 	) );
 83 | `
 84 | 
 85 | = List term images associated with a post object =
 86 | 
 87 | When a post is being displayed you may want to display all of the images associated with all of the terms that are associated with the post (a mouthful? Yes indeed!). The `taxonomy-images-list-the-terms` filter does this. Here's what it looks like in its simplest form:
 88 | 
 89 | `print apply_filters( 'taxonomy-images-list-the-terms', '' );`
 90 | 
 91 | This filter accepts an optional third parameter that you can use to customize its output. It is an array which recognizes the following keys:
 92 | 
 93 | * __after__ (string) - Text to append to the output. Default value is a closing unordered list element.
 94 | 
 95 | * __after_image__ (string) - Text to append to each image. Default value is a closing list-item element.
 96 | 
 97 | * __before__ (string) - Text to prepend to the output. Default value is an open unordered list element with an class attribute of "taxonomy-images-the-terms".
 98 | 
 99 | * __before_image__ (string) - Text to prepend to each image. Default value is an open list-item element.
100 | 
101 | * __image_size__ (string) - Any registered image size. Values will vary from installation to installation. Image sizes defined in core include: "thumbnail", "medium" and "large". "Fullsize" may also be used to get the unmodified image that was uploaded. Defaults to "thumbnail".
102 | 
103 | * __post_id__ (int) - The post to retrieve terms from. Defaults to the ID property of the global $post object.
104 | 
105 | * __taxonomy__ (string) - Name of a registered taxonomy to return terms from. Defaults to "category".
106 | 
107 | Here's an example of what a fully customized version of this filter might look like:
108 | 
109 | `
110 | print apply_filters( 'taxonomy-images-list-the-terms', '', array(
111 | 	'after'        => '</div>',
112 | 	'after_image'  => '</span>',
113 | 	'before'       => '<div class="my-custom-class-name">',
114 | 	'before_image' => '<span>',
115 | 	'image_size'   => 'detail',
116 | 	'post_id'      => 1234,
117 | 	'taxonomy'     => 'post_tag',
118 | 	) );
119 | `
120 | 
121 | = Working with all terms of a given taxonomy =
122 | 
123 | You will want to use the 'taxonomy-images-get-terms' filter. This filter is basically a wrapper for WordPress core function [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms). It will return an array of enhanced term objects: each term object will have a custom property named image_id which is an integer representing the database ID of the image associated with the term. This filter can be used to create custom lists of terms. Here's what it's default useage looks like:
124 | 
125 | `$terms = apply_filters( 'taxonomy-images-get-terms', '' );`
126 | 
127 | Here is what php's print_r() function may return:
128 | 
129 | `
130 | Array
131 | (
132 |     [0] => stdClass Object
133 |         (
134 |             [term_id] => 8
135 |             [name] => Pirate
136 |             [slug] => pirate
137 |             [term_group] => 0
138 |             [term_taxonomy_id] => 8
139 |             [taxonomy] => category
140 |             [description] => Pirates live in the ocean and ride around on boats.
141 |             [parent] => 0
142 |             [count] => 1
143 |             [image_id] => 44
144 |         )
145 | )
146 | `
147 | 
148 | As you can see, all of the goodness of get_terms() is there with an added bonus: the image_id parameter!
149 | 
150 | This filter recognizes an optional third parameter which is an array of arguments that can be used to modify its output:
151 | 
152 | * __cache_images__ (bool) If this value is true all assocaite images will be queried for and cached for later use in various template tags. If it is set to false, this query will be suppressed. Do not set this value to false unless you have a really good reason for doing so :) Default value is true.
153 | 
154 | * __having_images__ (bool) If this value is true then only terms that have associated images will be returned. Setting it to false will return all terms. Default value is true.
155 | 
156 | * __taxonomy__ (string) Name of a registered taxonomy to return terms from. Multiple taxonomies may be specified by separating each name by a comma. Defaults to "category".
157 | 
158 | * __term_args__ (array) Arguments to pass to [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms) as the second parameter. Default value is an empty array.
159 | 
160 | Here's and example of a simple custom loop that you can make to display all term images:
161 | 
162 | `
163 | $terms = apply_filters( 'taxonomy-images-get-terms', '' );
164 | if ( ! empty( $terms ) ) {
165 | 	print '<ul>';
166 | 	foreach( (array) $terms as $term ) {
167 | 		print '<li><a href="' . esc_url( get_term_link( $term, $term->taxonomy ) ) . '">' . wp_get_attachment_image( $term->image_id, 'detail' ) . '</li>';
168 | 	}
169 | 	print '</ul>';
170 | }
171 | `
172 | 
173 | = Support =
174 | 
175 | If you have questions about integrating this plugin into your site, please [add a new thread to the WordPress Support Forum](http://wordpress.org/tags/taxonomy-images?forum_id=10#postform). I try to answer these, but I may not always be able to. In the event that I cannot there may be someone else who can help.
176 | 
177 | = Bugs, Suggestions =
178 | 
179 | Development of this plugin is hosted in a public repository on [Github](https://github.com/mfields/Taxonomy-Images). If you find a bug in this plugin or have a suggestion to make it better, please [create a new issue](https://github.com/mfields/Taxonomy-Images/issues/new)
180 | 
181 | = Hook it up yo! =
182 | 
183 | If you have fallen in love with this plugin and would not be able to sleep without helping out in some way, please see the following list of ways that you can _hook it up!_:
184 | 
185 | * __Rate it!__ - Use the star tool on the right-hand sidebar of the [homepage](http://wordpress.org/extend/plugins/taxonomy-images/).
186 | 
187 | * __Let me know if it works__ - Use the _Compatibility_ widget on the [homepage](http://wordpress.org/extend/plugins/taxonomy-images/) to let everyone know that the current version works with your version of WordPress.
188 | 
189 | * __Do you Twitter?__ Help promote by using this shortlink: [http://bit.ly/taxonomy-images](http://bit.ly/taxonomy-images)
190 | 
191 | * __Are you a writer?__ Help promote by writing an article on your website about this plugin.
192 | 
193 | * __Are you Super-Wicked-Awesome?__ If so, you can always [make a donation](http://wordpress.mfields.org/donate/).
194 | 
195 | = Need More Taxonomy Plugins? =
196 | I've released a handfull of plugins dealing with taxonomies. Please see my [plugin page](http://wordpress.org/extend/plugins/profile/mfields) for more info.
197 | 
198 | ==Installation==
199 | 
200 | 1. Download
201 | 1. Unzip the package and upload to your /wp-content/plugins/ directory.
202 | 1. Log into WordPress and navigate to the "Plugins" panel.
203 | 1. Activate the plugin.
204 | 1. Click the "Taxonomy Images" link under the Settings section in the admin menu. There you can select the taxonomies that you would like to add image support for.
205 | 
206 | == Upgrade Notice ==
207 | 
208 | = 0.8 =
209 | Major and minor bug fixes tested with WordPres 3.6
210 | 
211 | = 0.7 =
212 | Complete rewrite. Better everything. Many bug fixes.
213 | 
214 | ==Changelog==
215 | 
216 | = 0.8.0 =
217 | * Pass an empty array as default second parameter of `taxonomy_images_plugin_get_the_terms()` and `taxonomy_images_plugin_list_the_terms()`.
218 | * Use jQuery.on() instead of jQuery.live(). Props [jamiemchale](http://profiles.wordpress.org/jamiemchale).
219 | * Give the button on the custom admin screen a class of `button-primary`.
220 | * Store the return value of `get_posts()` in a variable called `$images`. Not sure why, but this should not harm anything.
221 | * Change license to GPLv2 or later for maximum flexibility and compatibility.
222 | * Add jamiemchale as a contributor.
223 | * Random whitespace fixes.
224 | * Update Documentation.
225 | * CSS coding standards.
226 | * Bump version number.
227 | * Update Readmes.
228 | 
229 | = 0.7.3 =
230 | * Fixed the delete image button on edit-terms.php.
231 | * Better escaping.
232 | * Introduced pot file and languages directory.
233 | 
234 | = 0.7.2 =
235 | * Return data for fulsize images in archive views. [See this thread](http://wordpress.org/support/topic/image-size-full).
236 | 
237 | = 0.7.1 =
238 | * Remove unused link code which is throwing an error when no taxonomies support images.
239 | 
240 | = 0.7 =
241 | * No longer breaks display of the [Better Plugin Compatibility Control](http://wordpress.org/extend/plugins/better-plugin-compatibility-control/) plugin.
242 | * Created a custom filter interface for plugin and theme integration.
243 | * Lots of inline documentation added.
244 | * Added custom notices if plugin is used in an unsupported way.
245 | * No notices generated by PHP or WordPress.
246 | * Deprecated function calls removed.
247 | * Security updates.
248 | * All strings are now internationalized.
249 | * Add image to term functionality mimics "Add Featured Image".
250 | * Taxonomy modal button now available in search + upload states.
251 | * Image interface has been added to single term edit screen.
252 | * Users can now choose which taxonomys have image support.
253 | * All functions are now private.
254 | * Shortcode deprecated.
255 | * All global variables and constants have been removed or deprecated.
256 | 
257 | = 0.6 =
258 | * Never released.
259 | * Completely recoded.
260 | 
261 | = 0.5 =
262 | * __UPDATE:__ Direct link to upload new files from edit-tag.php has been introduced.
263 | * __UPDATE:__ Ability to create an image/term association immediately after upload has been introduced.
264 | * __UPDATE:__ Users can now delete image/term associations.
265 | * __UPDATE:__ Created standalone javascript files - removed inline scripts.
266 | * __UPDATE:__ Obsesive compulsive syntax modifications.
267 | * __UPDATE:__ Localization for strings - still need to "fine-tooth-comb" this.
268 | * __UPDATE:__ Removed all debug functions.
269 | 
270 | = 0.4.4 =
271 | * __BUGFIX:__ get_image_html() Now populates the image's alt attribute with appropriate data. Props to [jaygoldman](http://wordpress.org/support/profile/jaygoldman).
272 | 
273 | = 0.4.3 =
274 | * __UPDATE:__ Support for WordPress 3.0 has been added. Support for all beta versions of 3.0 has been dropped.
275 | * __COMPAT:__ Removed use of deprecated function is_taxonomy() - props to [anointed](http://profiles.wordpress.org/users/anointed).
276 | * __COMPAT:__ Included a definition for taxonomy_exists() function for backwards compatibility with 2.9 branch. This function is new in WordPress version 3.0.
277 | 
278 | = 0.4.2 =
279 | * __UPDATE:__ Changed button name from "Category" to "Taxonomy".
280 | * __UPDATE:__ Support for 2.9 branch has been added again.
281 | 
282 | = 0.4.1 =
283 | * __UPDATE:__ Added support for dynamic taxonomy hooks for _tag_row()
284 | * __BROKEN:__ Support for 2.9 branch has been temporarily removed.
285 | 
286 | = 0.4 =
287 | * __BUGFIX:__ get_thumb() now returns the fullsize url if there is no appropriate intermediate image.
288 | * __UPDATE:__ Added "taxonomy_images_shortcode".
289 | 
290 | = 0.3 =
291 | * __COMPAT:__ Changed the firing order of every hook untilizing the 'category_rows' method to 15. This allows this plugin to be compatible with [Reveal IDs for WP Admin](http://wordpress.org/extend/plugins/reveal-ids-for-wp-admin-25/). Thanks to [Peter Kahoun](http://profiles.wordpress.org/kahi/)
292 | * __COMPAT:__ Added Version check for PHP5.
293 | * __UPDATE:__ `$settings` and `$locale` are now public properties.
294 | * __UPDATE:__ Object name changed to: $taxonomy_images_plugin.
295 | * __UPDATE:__ Added argument $term_tax_id to both print_image_html() and get_image_html().
296 | * __BUGFIX:__ Deleted the register_deactivation_hook() function -> sorry to all 8 who downloaded this plugin so far :)
297 | 
298 | = 0.2 =
299 | * Original Release - Works With: wp 2.9.1.
300 | 


--------------------------------------------------------------------------------
/readme.md:
--------------------------------------------------------------------------------
  1 | Taxonomy Images
  2 | ===============
  3 | 
  4 | A WordPress plugin that enables you to associate images from your media library to categories, tags and custom taxonomies. For usage instructions please view the [screencast](http://screenr.com/zMx).
  5 | 
  6 | 
  7 | Displaying Your Images in Your Theme
  8 | ------------------------------------
  9 | 
 10 | There are a few filters that you can use in your theme to display the image associations created by this plugin. Please read below for detailed information.
 11 | 
 12 | 
 13 | Display a single image representing the term archive
 14 | ----------------------------------------------------
 15 | 
 16 | The following filter will display the image associated with the term asked for in the query string of the url. This filter only works in views that naturally use templates like category.php, tag.php taxonomy.php and all of their derivatives. Please read about [template hierarchy](http://codex.wordpress.org/Template_Hierarchy) for more information about these templates. The simplest use of this filter looks like:
 17 | 
 18 |     print apply_filters( 'taxonomy-images-queried-term-image', '' );
 19 | 
 20 | This code will generate and print an image tag. It's output can be modifed by passig an optional third parameter to apply filters. This parameter is an array and the following keys may be set:
 21 | 
 22 | * __after__ (string) - Text to append to the image's HTML.
 23 | 
 24 | * __attr__ (array) - Key/value pairs representing the attributes of the img tag. Available options include: alt, class, src and title. This array will be passed as the fourth parameter to WordPress core function wp_get_attachment_image() without modification.
 25 | 
 26 | * __before__ (string) - Text to prepend to the image's HTML.
 27 | 
 28 | * __image_size__ (string) - May be any image size registered with WordPress. If no image size is specified, 'thumbnail' will be used as a default value. In the event that an unregistered size is specified, this filter will return an empty string.
 29 | 
 30 | Here's an example of what a fully customized version of this filter might look like:
 31 | 
 32 |     print apply_filters( 'taxonomy-images-queried-term-image', '', array(
 33 |         'after' => '</div>'
 34 |     'attr' => array(
 35 |         'alt'   => 'Custom alternative text',
 36 |         'class' => 'my-class-list bunnies turtles',
 37 |         'src'   => 'this-is-where-the-image-lives.png',
 38 |         'title' => 'Custom Title',
 39 |         ),
 40 |     'before' => '<div id="my-custom-div">',
 41 |     'image_size' => 'medium',
 42 |     ) );
 43 | 
 44 | 
 45 | Similar functionality
 46 | ---------------------
 47 | 
 48 | If you just need to get the database ID for the image, you may want to use:
 49 | 
 50 |     $image_id = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );
 51 | 
 52 | If you need to get the full object of the image, you may want to use:
 53 | 
 54 |     $image = apply_filters( 'taxonomy-images-queried-term-image-object', '' );
 55 | 
 56 | If you need to get the url to the image, you may want to use the following:
 57 | 
 58 |     $image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '' );
 59 | 
 60 | You can specify the size of the image in an option third parameter:
 61 | 
 62 |     $image_url = apply_filters( 'taxonomy-images-queried-term-image-url', '', array(
 63 |         'image_size' => 'medium'
 64 |         ) );
 65 | 
 66 | 
 67 | If you need data about the image, you may want to use:
 68 | 
 69 |     $image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '' );
 70 | 
 71 | You can specify the size of the image in an option third parameter:
 72 | 
 73 | 
 74 |     $image_data = apply_filters( 'taxonomy-images-queried-term-image-data', '', array(
 75 |         'image_size' => 'medium'
 76 |         ) );
 77 | 
 78 | List term images associated with a post object
 79 | ----------------------------------------------
 80 | 
 81 | When a post is being displayed you may want to display all of the images associated with all of the terms that are associated with the post (a mouthful? Yes indeed!). The `taxonomy-images-list-the-terms` filter does this. Here's what it looks like in its simplest form:
 82 | 
 83 |     print apply_filters( 'taxonomy-images-list-the-terms', '' );
 84 | 
 85 | This filter accepts an optional third parameter that you can use to customize its output. It is an array which recognizes the following keys:
 86 | 
 87 | * __after__ (string) - Text to append to the output. Default value is a closing unordered list element.
 88 | 
 89 | * __after_image__ (string) - Text to append to each image. Default value is a closing list-item element.
 90 | 
 91 | * __before__ (string) - Text to prepend to the output. Default value is an open unordered list element with an class attribute of "taxonomy-images-the-terms".
 92 | 
 93 | * __before_image__ (string) - Text to prepend to each image. Default value is an open list-item element.
 94 | 
 95 | * __image_size__ (string) - Any registered image size. Values will vary from installation to installation. Image sizes defined in core include: "thumbnail", "medium" and "large". "Fullsize" may also be used to get the unmodified image that was uploaded. Defaults to "thumbnail".
 96 | 
 97 | * __post_id__ (int) - The post to retrieve terms from. Defaults to the ID property of the global $post object.
 98 | 
 99 | * __taxonomy__ (string) - Name of a registered taxonomy to return terms from. Defaults to "category".
100 | 
101 | Here's an example of what a fully customized version of this filter might look like:
102 | 
103 |     print apply_filters( 'taxonomy-images-list-the-terms', '', array(
104 |         'after'        => '</div>',
105 |         'after_image'  => '</span>',
106 |         'before'       => '<div class="my-custom-class-name">',
107 |         'before_image' => '<span>',
108 |         'image_size'   => 'detail',
109 |         'post_id'      => 1234,
110 |         'taxonomy'     => 'post_tag',
111 |         ) );
112 | 
113 | Working with all terms of a given taxonomy
114 | ------------------------------------------
115 | 
116 | You will want to use the 'taxonomy-images-get-terms' filter. This filter is basically a wrapper for WordPress core function [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms). It will return an array of enhanced term objects: each term object will have a custom property named image_id which is an integer representing the database ID of the image associated with the term. This filter can be used to create custom lists of terms. Here's what it's default useage looks like:
117 | 
118 |     $terms = apply_filters( 'taxonomy-images-get-terms', '' );
119 | 
120 | Here is what php's print_r() function may return:
121 | 
122 |     Array
123 |     (
124 |     [0] => stdClass Object
125 |         (
126 |             [term_id] => 8
127 |             [name] => Pirate
128 |             [slug] => pirate
129 |             [term_group] => 0
130 |             [term_taxonomy_id] => 8
131 |             [taxonomy] => category
132 |             [description] => Pirates live in the ocean and ride around on boats.
133 |             [parent] => 0
134 |             [count] => 1
135 |             [image_id] => 44
136 |         )
137 | )
138 | 
139 | As you can see, all of the goodness of get_terms() is there with an added bonus: the image_id parameter!
140 | 
141 | This filter recognizes an optional third parameter which is an array of arguments that can be used to modify its output:
142 | 
143 | * __cache_images__ (bool) If this value is true all assocaite images will be queried for and cached for later use in various template tags. If it is set to false, this query will be suppressed. Do not set this value to false unless you have a really good reason for doing so :) Default value is true.
144 | 
145 | * __having_images__ (bool) If this value is true then only terms that have associated images will be returned. Setting it to false will return all terms. Default value is true.
146 | 
147 | * __taxonomy__ (string) Name of a registered taxonomy to return terms from. Multiple taxonomies may be specified by separating each name by a comma. Defaults to "category".
148 | 
149 | * __term_args__ (array) Arguments to pass to [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms) as the second parameter. Default value is an empty array.
150 | 
151 | Here's and example of a simple custom loop that you can make to display all term images:
152 | 
153 |     $terms = apply_filters( 'taxonomy-images-get-terms', '' );
154 |     if ( ! empty( $terms ) ) {
155 |         print '<ul>';
156 |         foreach( (array) $terms as $term ) {
157 |             print '<li><a href="' . esc_url( get_term_link( $term, $term->taxonomy ) ) . '">' . wp_get_attachment_image( $term->image_id, 'detail' ) . '</li>';
158 |         }
159 |         print '</ul>';
160 |     }
161 | 
162 | 
163 | Support
164 | -------
165 | 
166 | If you have questions about integrating this plugin into your site, please [add a new thread to the WordPress Support Forum](http://wordpress.org/tags/taxonomy-images?forum_id=10#postform). I try to answer these, but I may not always be able to. In the event that I cannot there may be someone else who can help.
167 | 
168 | 
169 | Bugs, Suggestions
170 | -----------------
171 | 
172 | Development of this plugin is hosted in a public repository on [Github](https://github.com/mfields/Taxonomy-Images). If you find a bug in this plugin or have a suggestion to make it better, please [create a new issue](https://github.com/mfields/Taxonomy-Images/issues/new)
173 | 
174 | 
175 | Hook it up yo!
176 | --------------
177 | 
178 | If you have fallen in love with this plugin and would not be able to sleep without helping out in some way, please see the following list of ways that you can _hook it up!_:
179 | 
180 | * __Rate it!__ - Use the star tool on the right-hand sidebar of the [homepage](http://wordpress.org/extend/plugins/taxonomy-images/).
181 | 
182 | * __Let me know if it works__ - Use the _Compatibility_ widget on the [homepage](http://wordpress.org/extend/plugins/taxonomy-images/) to let everyone know that the current version works with your version of WordPress.
183 | 
184 | * __Do you Twitter?__ Help promote by using this shortlink: [http://bit.ly/taxonomy-images](http://bit.ly/taxonomy-images)
185 | 
186 | * __Are you a writer?__ Help promote by writing an article on your website about this plugin.
187 | 
188 | * __Are you Super-Wicked-Awesome?__ If so, you can always [make a donation](http://wordpress.mfields.org/donate/).
189 | 
190 | 
191 | Need More Taxonomy Plugins?
192 | ---------------------------
193 | 
194 | I've released a handfull of plugins dealing with taxonomies. Please see my [plugin page](http://wordpress.org/extend/plugins/profile/mfields) for more info.
195 | 
196 | 
197 | Installation
198 | ------------
199 | 
200 | 1. Download
201 | 1. Unzip the package and upload to your /wp-content/plugins/ directory.
202 | 1. Log into WordPress and navigate to the "Plugins" panel.
203 | 1. Activate the plugin.
204 | 1. Click the "Taxonomy Images" link under the Settings section in the admin menu. There you can select the taxonomies that you would like to add image support for.
205 | 
206 | 
207 | Changelog
208 | ---------
209 | 
210 | __0.8.0__
211 | 
212 | * Pass an empty array as default second parameter of `taxonomy_images_plugin_get_the_terms()` and `taxonomy_images_plugin_list_the_terms()`.
213 | * Use jQuery.on() instead of jQuery.live(). Props [jamiemchale](http://profiles.wordpress.org/jamiemchale).
214 | * Give the button on the custom admin screen a class of `button-primary`.
215 | * Store the return value of `get_posts()` in a variable called `$images`. Not sure why, but this should not harm anything.
216 | * Change license to GPLv2 or later for maximum flexibility and compatibility.
217 | * Add jamiemchale as a contributor.
218 | * Random whitespace fixes.
219 | * Update Documentation.
220 | * CSS coding standards.
221 | * Bump version number.
222 | * Update Readmes.
223 | 
224 | __0.7.3__
225 | 
226 | * Fixed the delete image button on edit-terms.php.
227 | * Better escaping.
228 | * Introduced pot file and languages directory.
229 | 
230 | __0.7.2__
231 | 
232 | * Return data for fulsize images in archive views. [See this thread](http://wordpress.org/support/topic/image-size-full).
233 | 
234 | __0.7.1__
235 | 
236 | * Remove unused link code which is throwing an error when no taxonomies support images.
237 | 
238 | __0.7__
239 | 
240 | * No longer breaks display of the [Better Plugin Compatibility Control](http://wordpress.org/extend/plugins/better-plugin-compatibility-control/) plugin.
241 | * Created a custom filter interface for plugin and theme integration.
242 | * Lots of inline documentation added.
243 | * Added custom notices if plugin is used in an unsupported way.
244 | * No notices generated by PHP or WordPress.
245 | * Deprecated function calls removed.
246 | * Security updates.
247 | * All strings are now internationalized.
248 | * Add image to term functionality mimics "Add Featured Image".
249 | * Taxonomy modal button now available in search + upload states.
250 | * Image interface has been added to single term edit screen.
251 | * Users can now choose which taxonomys have image support.
252 | * All functions are now private.
253 | * Shortcode deprecated.
254 | * All global variables and constants have been removed or deprecated.
255 | 
256 | __0.6__
257 | 
258 | * Never released.
259 | * Completely recoded.
260 | 
261 | __0.5__
262 | 
263 | * __UPDATE:__ Direct link to upload new files from edit-tag.php has been introduced.
264 | * __UPDATE:__ Ability to create an image/term association immediately after upload has been introduced.
265 | * __UPDATE:__ Users can now delete image/term associations.
266 | * __UPDATE:__ Created standalone javascript files - removed inline scripts.
267 | * __UPDATE:__ Obsesive compulsive syntax modifications.
268 | * __UPDATE:__ Localization for strings - still need to "fine-tooth-comb" this.
269 | * __UPDATE:__ Removed all debug functions.
270 | 
271 | __0.4.4__
272 | 
273 | * __BUGFIX:__ get_image_html() Now populates the image's alt attribute with appropriate data. Props to [jaygoldman](http://wordpress.org/support/profile/jaygoldman).
274 | 
275 | __0.4.3__
276 | 
277 | * __UPDATE:__ Support for WordPress 3.0 has been added. Support for all beta versions of 3.0 has been dropped.
278 | * __COMPAT:__ Removed use of deprecated function is_taxonomy() - props to [anointed](http://profiles.wordpress.org/users/anointed).
279 | * __COMPAT:__ Included a definition for taxonomy_exists() function for backwards compatibility with 2.9 branch. This function is new in WordPress version 3.0.
280 | 
281 | __0.4.2__
282 | 
283 | * __UPDATE:__ Changed button name from "Category" to "Taxonomy".
284 | * __UPDATE:__ Support for 2.9 branch has been added again.
285 | 
286 | __0.4.1__
287 | 
288 | * __UPDATE:__ Added support for dynamic taxonomy hooks for _tag_row()
289 | * __BROKEN:__ Support for 2.9 branch has been temporarily removed.
290 | 
291 | __0.4__
292 | 
293 | * __BUGFIX:__ get_thumb() now returns the fullsize url if there is no appropriate intermediate image.
294 | * __UPDATE:__ Added "taxonomy_images_shortcode".
295 | 
296 | __0.3__
297 | 
298 | * __COMPAT:__ Changed the firing order of every hook untilizing the 'category_rows' method to 15. This allows this plugin to be compatible with [Reveal IDs for WP Admin](http://wordpress.org/extend/plugins/reveal-ids-for-wp-admin-25/). Thanks to [Peter Kahoun](http://profiles.wordpress.org/kahi/)
299 | * __COMPAT:__ Added Version check for PHP5.
300 | * __UPDATE:__ `$settings` and `$locale` are now public properties.
301 | * __UPDATE:__ Object name changed to: $taxonomy_images_plugin.
302 | * __UPDATE:__ Added argument $term_tax_id to both print_image_html() and get_image_html().
303 | * __BUGFIX:__ Deleted the register_deactivation_hook() function -> sorry to all 8 who downloaded this plugin so far :)
304 | 
305 | __0.2__
306 | 
307 | * Original Release - Works With: wp 2.9.1.
308 | 


--------------------------------------------------------------------------------
/public-filters.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Interface.
  4 |  *
  5 |  * All functions defined in this plugin should be considered
  6 |  * private meaning that they are not to be used in any other
  7 |  * WordPress extension including plugins and themes. Direct
  8 |  * use of functions defined herein constitutes unsupported use
  9 |  * and is strongly discouraged. This file contains custom filters
 10 |  * which enable extension authors to interact with this plugin in
 11 |  * a responsible manner.
 12 |  *
 13 |  * @package      Taxonomy Images
 14 |  * @author       Michael Fields <michael@mfields.org>
 15 |  * @copyright    Copyright (c) 2011, Michael Fields
 16 |  * @license      http://opensource.org/licenses/gpl-2.0.php GNU Public License
 17 |  * @since        0.7
 18 |  */
 19 | 
 20 | 
 21 | add_filter( 'taxonomy-images-get-terms',      'taxonomy_images_plugin_get_terms', 10, 2 );
 22 | add_filter( 'taxonomy-images-get-the-terms',  'taxonomy_images_plugin_get_the_terms', 10, 2 );
 23 | add_filter( 'taxonomy-images-list-the-terms', 'taxonomy_images_plugin_list_the_terms', 10, 2 );
 24 | 
 25 | add_filter( 'taxonomy-images-queried-term-image',        'taxonomy_images_plugin_get_queried_term_image', 10, 2 );
 26 | add_filter( 'taxonomy-images-queried-term-image-data',   'taxonomy_images_plugin_get_queried_term_image_data', 10, 2 );
 27 | add_filter( 'taxonomy-images-queried-term-image-id',     'taxonomy_images_plugin_get_queried_term_image_id' );
 28 | add_filter( 'taxonomy-images-queried-term-image-object', 'taxonomy_images_plugin_get_queried_term_image_object' );
 29 | add_filter( 'taxonomy-images-queried-term-image-url',    'taxonomy_images_plugin_get_queried_term_image_url', 10, 2 );
 30 | 
 31 | 
 32 | /**
 33 |  * Get Terms.
 34 |  *
 35 |  * This function adds a custom property (image_id) to each
 36 |  * object returned by WordPress core function get_terms().
 37 |  * This property will be set for all term objects. In cases
 38 |  * where a term has an associated image, "image_id" will
 39 |  * contain the value of the image object's ID property. If
 40 |  * no image has been associated, this property will contain
 41 |  * integer with the value of zero.
 42 |  *
 43 |  * @see http://codex.wordpress.org/Function_Reference/get_terms
 44 |  *
 45 |  * Recognized Arguments:
 46 |  *
 47 |  * cache_images (bool) If true, all images will be added to
 48 |  * WordPress object cache. If false, caching will not occur.
 49 |  * Defaults to true. Optional.
 50 |  *
 51 |  * having_images (bool) If true, the returned array will contain
 52 |  * only terms that have associated images. If false, all terms
 53 |  * of the taxonomy will be returned. Defaults to true. Optional.
 54 |  *
 55 |  * taxonomy (string) Name of a registered taxonomy to
 56 |  * return terms from. Defaults to "category". Optional.
 57 |  *
 58 |  * term_args (array) Arguments to pass as the second
 59 |  * parameter of get_terms(). Defaults to an empty array.
 60 |  * Optional.
 61 |  *
 62 |  * @param     mixed     Default value for apply_filters() to return. Unused.
 63 |  * @param     array     Named arguments. Please see above for explantion.
 64 |  * @return    array     List of term objects.
 65 |  *
 66 |  * @access    private   Use the 'taxonomy-images-get-terms' filter.
 67 |  * @since     0.7
 68 |  */
 69 | function taxonomy_images_plugin_get_terms( $default, $args = array() ) {
 70 | 	$filter = 'taxonomy-images-get-terms';
 71 | 	if ( $filter !== current_filter() ) {
 72 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
 73 | 	}
 74 | 
 75 | 	$args = wp_parse_args( $args, array(
 76 | 		'cache_images'  => true,
 77 | 		'having_images' => true,
 78 | 		'taxonomy'      => 'category',
 79 | 		'term_args'     => array(),
 80 | 		) );
 81 | 
 82 | 	$args['taxonomy'] = explode( ',', $args['taxonomy'] );
 83 | 	$args['taxonomy'] = array_map( 'trim', $args['taxonomy'] );
 84 | 
 85 | 	foreach ( $args['taxonomy'] as $taxonomy ) {
 86 | 		if ( ! taxonomy_image_plugin_check_taxonomy( $taxonomy, $filter ) ) {
 87 | 			return array();
 88 | 		}
 89 | 	}
 90 | 
 91 | 	$assoc = taxonomy_image_plugin_get_associations();
 92 | 	if ( empty( $assoc ) ) {
 93 | 		return array();
 94 | 	}
 95 | 
 96 | 	$terms = get_terms( $args['taxonomy'], $args['term_args'] );
 97 | 	if ( is_wp_error( $terms ) ) {
 98 | 		return array();
 99 | 	}
100 | 
101 | 	$image_ids = array();
102 | 	$terms_with_images = array();
103 | 	foreach ( (array) $terms as $key => $term ) {
104 | 		$terms[$key]->image_id = 0;
105 | 		if ( array_key_exists( $term->term_taxonomy_id, $assoc ) ) {
106 | 			$terms[$key]->image_id = $assoc[$term->term_taxonomy_id];
107 | 			$image_ids[] = $assoc[$term->term_taxonomy_id];
108 | 			if ( ! empty( $args['having_images'] ) ) {
109 | 				$terms_with_images[] = $terms[$key];
110 | 			}
111 | 		}
112 | 	}
113 | 	$image_ids = array_unique( $image_ids );
114 | 
115 | 	if ( ! empty( $args['cache_images'] ) ) {
116 | 		$images = array();
117 | 		if ( ! empty( $image_ids ) ) {
118 | 			$images = get_children( array( 'include' => implode( ',', $image_ids ) ) );
119 | 		}
120 | 	}
121 | 
122 | 	if ( ! empty( $terms_with_images ) ) {
123 | 		return $terms_with_images;
124 | 	}
125 | 	return $terms;
126 | }
127 | 
128 | 
129 | /**
130 |  * Get the Terms.
131 |  *
132 |  * This function adds a custom property (image_id) to each
133 |  * object returned by WordPress core function get_the_terms().
134 |  * This property will be set for all term objects. In cases
135 |  * where a term has an associated image, "image_id" will
136 |  * contain the value of the image object's ID property. If
137 |  * no image has been associated, this property will contain
138 |  * integer with the value of zero.
139 |  *
140 |  * @see http://codex.wordpress.org/Function_Reference/get_the_terms
141 |  *
142 |  * Recognized Arguments:
143 |  *
144 |  * having_images (bool) If true, the returned array will contain
145 |  * only terms that have associated images. If false, all terms
146 |  * of the taxonomy will be returned. Defaults to true. Optional.
147 |  *
148 |  * post_id (int) The post to retrieve terms from. Defaults
149 |  * to the ID property of the global $post object. Optional.
150 |  *
151 |  * taxonomy (string) Name of a registered taxonomy to
152 |  * return terms from. Defaults to "category". Optional.
153 |  *
154 |  * @param     mixed     Default value for apply_filters() to return. Unused.
155 |  * @param     array     Named arguments. Please see above for explantion.
156 |  * @return    array     List of term objects. Empty array if none were found.
157 |  *
158 |  * @access    private   Use the 'taxonomy-images-get-the-terms' filter.
159 |  * @since     0.7
160 |  */
161 | function taxonomy_images_plugin_get_the_terms( $default, $args = array() ) {
162 | 	$filter = 'taxonomy-images-get-the-terms';
163 | 	if ( $filter !== current_filter() ) {
164 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
165 | 	}
166 | 
167 | 	$args = wp_parse_args( $args, array(
168 | 		'having_images' => true,
169 | 		'post_id'       => 0,
170 | 		'taxonomy'      => 'category',
171 | 		) );
172 | 
173 | 	if ( ! taxonomy_image_plugin_check_taxonomy( $args['taxonomy'], $filter ) ) {
174 | 		return array();
175 | 	}
176 | 
177 | 	$assoc = taxonomy_image_plugin_get_associations();
178 | 
179 | 	if ( empty( $args['post_id'] ) ) {
180 | 		$args['post_id'] = get_the_ID();
181 | 	}
182 | 
183 | 	$terms = get_the_terms( $args['post_id'], $args['taxonomy'] );
184 | 
185 | 	if ( is_wp_error( $terms ) ) {
186 | 		return array();
187 | 	}
188 | 
189 | 	if ( empty( $terms ) ) {
190 | 		return array();
191 | 	}
192 | 
193 | 	$terms_with_images = array();
194 | 	foreach ( (array) $terms as $key => $term ) {
195 | 		$terms[$key]->image_id = 0;
196 | 		if ( array_key_exists( $term->term_taxonomy_id, $assoc ) ) {
197 | 			$terms[$key]->image_id = $assoc[$term->term_taxonomy_id];
198 | 			if ( ! empty( $args['having_images'] ) ) {
199 | 				$terms_with_images[] = $terms[$key];
200 | 			}
201 | 		}
202 | 	}
203 | 	if ( ! empty( $terms_with_images ) ) {
204 | 		return $terms_with_images;
205 | 	}
206 | 	return $terms;
207 | }
208 | 
209 | 
210 | /**
211 |  * List the Terms.
212 |  *
213 |  * Lists all terms associated with a given post that
214 |  * have associated images. Terms without images will
215 |  * not be included.
216 |  *
217 |  * Recognized Arguments:
218 |  *
219 |  * after (string) Text to append to the output.
220 |  * Defaults to: '</ul>'. Optional.
221 |  *
222 |  * after_image (string) Text to append to each image in the
223 |  * list. Defaults to: '</li>'. Optional.
224 |  *
225 |  * before (string) Text to preppend to the output.
226 |  * Defaults to: '<ul class="taxonomy-images-the-terms">'.
227 |  * Optional.
228 |  *
229 |  * before_image (string) Text to prepend to each image in the
230 |  * list. Defaults to: '<li>'. Optional.
231 |  *
232 |  * image_size (string) Any registered image size. Values will
233 |  * vary from installation to installation. Image sizes defined
234 |  * in core include: "thumbnail", "medium" and "large". "fullsize"
235 |  * may also be used to get the unmodified image that was uploaded.
236 |  * Optional. Defaults to "thumbnail".
237 |  *
238 |  * post_id (int) The post to retrieve terms from. Defaults
239 |  * to the ID property of the global $post object. Optional.
240 |  *
241 |  * taxonomy (string) Name of a registered taxonomy to
242 |  * return terms from. Defaults to "category". Optional.
243 |  *
244 |  * @param     mixed     Default value for apply_filters() to return. Unused.
245 |  * @param     array     Named arguments. Please see above for explantion.
246 |  * @return    string    HTML markup.
247 |  *
248 |  * @access    private   Use the 'taxonomy-images-list-the-terms' filter.
249 |  * @since     0.7
250 |  */
251 | function taxonomy_images_plugin_list_the_terms( $default, $args = array() ) {
252 | 	$filter = 'taxonomy-images-list-the-terms';
253 | 	if ( $filter !== current_filter() ) {
254 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
255 | 	}
256 | 
257 | 	$args = wp_parse_args( $args, array(
258 | 		'after'        => '</ul>',
259 | 		'after_image'  => '</li>',
260 | 		'before'       => '<ul class="taxonomy-images-the-terms">',
261 | 		'before_image' => '<li>',
262 | 		'image_size'   => 'thumbnail',
263 | 		'post_id'      => 0,
264 | 		'taxonomy'     => 'category',
265 | 		) );
266 | 
267 | 	$args['having_images'] = true;
268 | 
269 | 	if ( ! taxonomy_image_plugin_check_taxonomy( $args['taxonomy'], $filter ) ) {
270 | 		return '';
271 | 	}
272 | 
273 | 	$terms = apply_filters( 'taxonomy-images-get-the-terms', '', $args );
274 | 
275 | 	if ( empty( $terms ) ) {
276 | 		return '';
277 | 	}
278 | 
279 | 	$output = '';
280 | 	foreach( $terms as $term ) {
281 | 		if ( ! isset( $term->image_id ) ) {
282 | 			continue;
283 | 		}
284 | 		$image = wp_get_attachment_image( $term->image_id, $args['image_size'] );
285 | 		if ( ! empty( $image ) ) {
286 | 			$output .= $args['before_image'] . '<a href="' . esc_url( get_term_link( $term, $term->taxonomy ) ) . '">' . $image .'</a>' . $args['after_image'];
287 | 		}
288 | 	}
289 | 
290 | 	if ( ! empty( $output ) ) {
291 | 		return $args['before'] . $output . $args['after'];
292 | 	}
293 | 	return '';
294 | }
295 | 
296 | 
297 | /**
298 |  * Queried Term Image.
299 |  *
300 |  * Prints html markup for the image associated with
301 |  * the current queried term.
302 |  *
303 |  * Recognized Arguments:
304 |  *
305 |  * after (string) - Text to append to the image's HTML.
306 |  *
307 |  * before (string) - Text to prepend to the image's HTML.
308 |  *
309 |  * image_size (string) - May be any image size registered with
310 |  * WordPress. If no image size is specified, 'thumbnail' will be
311 |  * used as a default value. In the event that an unregistered size
312 |  * is specified, this function will return an empty string.
313 |  *
314 |  * Designed to be used in archive templates including
315 |  * (but not limited to) archive.php, category.php, tag.php,
316 |  * taxonomy.php as well as derivatives of these templates.
317 |  *
318 |  * @param     mixed     Default value for apply_filters() to return. Unused.
319 |  * @param     array     Named array of arguments.
320 |  * @return    string    HTML markup for the associated image.
321 |  *
322 |  * @access    private   Use the 'taxonomy-images-queried-term-image' filter.
323 |  * @since     0.7
324 |  */
325 | function taxonomy_images_plugin_get_queried_term_image( $default, $args = array() ) {
326 | 	$filter = 'taxonomy-images-queried-term-image';
327 | 	if ( $filter !== current_filter() ) {
328 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
329 | 	}
330 | 
331 | 	$args = wp_parse_args( $args, array(
332 | 		'after'      => '',
333 | 		'attr'       => array(),
334 | 		'before'     => '',
335 | 		'image_size' => 'thumbnail',
336 | 		) );
337 | 
338 | 	$ID = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );
339 | 
340 | 	if ( empty( $ID ) ) {
341 | 		return '';
342 | 	}
343 | 
344 | 	$html = wp_get_attachment_image( $ID, $args['image_size'], false, $args['attr'] );
345 | 
346 | 	if ( empty( $html ) ) {
347 | 		return '';
348 | 	}
349 | 
350 | 	return $args['before'] . $html . $args['after'];
351 | }
352 | 
353 | 
354 | /**
355 |  * Queried Term Image ID.
356 |  *
357 |  * Designed to be used in archive templates including
358 |  * (but not limited to) archive.php, category.php, tag.php,
359 |  * taxonomy.php as well as derivatives of these templates.
360 |  *
361 |  * Returns an integer representing the image attachment's ID.
362 |  * In the event that an image has been associated zero will
363 |  * be returned.
364 |  *
365 |  * This function should never be called directly in any file
366 |  * however it may be access in any template file via the
367 |  * 'taxonomy-images-queried-term-image-id' filter.
368 |  *
369 |  * @param     mixed     Default value for apply_filters() to return. Unused.
370 |  * @return    int       Image attachment's ID.
371 |  *
372 |  * @access    private   Use the 'taxonomy-images-queried-term-image-id' filter.
373 |  * @since     0.7
374 |  */
375 | function taxonomy_images_plugin_get_queried_term_image_id( $default ) {
376 | 	$filter = 'taxonomy-images-queried-term-image-id';
377 | 	if ( $filter !== current_filter() ) {
378 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
379 | 	}
380 | 
381 | 	$obj = get_queried_object();
382 | 
383 | 	/* Return early is we are not in a term archive. */
384 | 	if ( ! isset( $obj->term_taxonomy_id ) ) {
385 | 		trigger_error( sprintf( esc_html__( '%1$s is not a property of the current queried object. This usually happens when the %2$s filter is used in an unsupported template file. This filter has been designed to work in taxonomy archives which are traditionally served by one of the following template files: category.php, tag.php or taxonomy.php. Learn more about %3$s.', 'taxonomy-images' ),
386 | 			'<code>' . esc_html__( 'term_taxonomy_id', 'taxonomy-images' ) . '</code>',
387 | 			'<code>' . esc_html( $filter ) . '</code>',
388 | 			'<a href="http://codex.wordpress.org/Template_Hierarchy">' . esc_html( 'template hierarchy', 'taxonomy-images' ) . '</a>'
389 | 			) );
390 | 		return 0;
391 | 	}
392 | 
393 | 	if ( ! taxonomy_image_plugin_check_taxonomy( $obj->taxonomy, $filter ) ) {
394 | 		return 0;
395 | 	}
396 | 
397 | 	$associations = taxonomy_image_plugin_get_associations();
398 | 	$tt_id = absint( $obj->term_taxonomy_id );
399 | 
400 | 	$ID = 0;
401 | 	if ( array_key_exists( $tt_id, $associations ) ) {
402 | 		$ID = absint( $associations[$tt_id] );
403 | 	}
404 | 
405 | 	return $ID;
406 | }
407 | 
408 | 
409 | /**
410 |  * Queried Term Image Object.
411 |  *
412 |  * Returns all data stored in the WordPress posts table for
413 |  * the image associated with the term in object form. In the
414 |  * event that no image is found an empty object will be returned.
415 |  *
416 |  * Designed to be used in archive templates including
417 |  * (but not limited to) archive.php, category.php, tag.php,
418 |  * taxonomy.php as well as derivatives of these templates.
419 |  *
420 |  * This function should never be called directly in any file
421 |  * however it may be access in any template file via the
422 |  * 'taxonomy-images-queried-term-image' filter.
423 |  *
424 |  * @param     mixed          Default value for apply_filters() to return. Unused.
425 |  * @return    stdClass       WordPress Post object.
426 |  *
427 |  * @access    private        Use the 'taxonomy-images-queried-term-image-object' filter.
428 |  * @since     0.7
429 |  */
430 | function taxonomy_images_plugin_get_queried_term_image_object( $default ) {
431 | 	$filter = 'taxonomy-images-queried-term-image-object';
432 | 	if ( $filter !== current_filter() ) {
433 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
434 | 	}
435 | 
436 | 	$ID = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );
437 | 
438 | 	$image = new stdClass;
439 | 	if ( ! empty( $ID ) ) {
440 | 		$image = get_post( $ID );
441 | 	}
442 | 	return $image;
443 | }
444 | 
445 | /**
446 |  * Queried Term Image URL.
447 |  *
448 |  * Returns a url to the image associated with the current queried
449 |  * term. In the event that no image is found an empty string will
450 |  * be returned.
451 |  *
452 |  * Designed to be used in archive templates including
453 |  * (but not limited to) archive.php, category.php, tag.php,
454 |  * taxonomy.php as well as derivatives of these templates.
455 |  *
456 |  * Recognized Arguments
457 |  *
458 |  * image_size (string) - May be any image size registered with
459 |  * WordPress. If no image size is specified, 'thumbnail' will be
460 |  * used as a default value. In the event that an unregistered size
461 |  * is specified, this function will return an empty string.
462 |  *
463 |  * @param     mixed          Default value for apply_filters() to return. Unused.
464 |  * @param     array          Named Arguments.
465 |  * @return    string         Image URL.
466 |  *
467 |  * @access    private        Use the 'taxonomy-images-queried-term-image-url' filter.
468 |  * @since     0.7
469 |  */
470 | function taxonomy_images_plugin_get_queried_term_image_url( $default, $args = array() ) {
471 | 	$filter = 'taxonomy-images-queried-term-image-url';
472 | 	if ( $filter !== current_filter() ) {
473 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
474 | 	}
475 | 
476 | 	$args = wp_parse_args( $args, array(
477 | 		'image_size' => 'thumbnail',
478 | 		) );
479 | 
480 | 	$data = apply_filters( 'taxonomy-images-queried-term-image-data', array(), $args );
481 | 
482 | 	$url = '';
483 | 	if ( isset( $data['url'] ) ) {
484 | 		$url = $data['url'];
485 | 	}
486 | 	return $url;
487 | }
488 | 
489 | 
490 | /**
491 |  * Queried Term Image Data.
492 |  *
493 |  * Returns a url to the image associated with the current queried
494 |  * term. In the event that no image is found an empty string will
495 |  * be returned.
496 |  *
497 |  * Designed to be used in archive templates including
498 |  * (but not limited to) archive.php, category.php, tag.php,
499 |  * taxonomy.php as well as derivatives of these templates.
500 |  *
501 |  * Recognized Arguments
502 |  *
503 |  * image_size (string) - May be any image size registered with
504 |  * WordPress. If no image size is specified, 'thumbnail' will be
505 |  * used as a default value. In the event that an unregistered size
506 |  * is specified, this function will return an empty array.
507 |  *
508 |  * @param     mixed          Default value for apply_filters() to return. Unused.
509 |  * @param     array          Named Arguments.
510 |  * @return    array          Image data: url, width and height.
511 |  *
512 |  * @access    private        Use the 'taxonomy-images-queried-term-image-data' filter.
513 |  * @since     0.7
514 |  * @alter     0.7.2
515 |  */
516 | function taxonomy_images_plugin_get_queried_term_image_data( $default, $args = array() ) {
517 | 	$filter = 'taxonomy-images-queried-term-image-data';
518 | 	if ( $filter !== current_filter() ) {
519 | 		taxonomy_image_plugin_please_use_filter( __FUNCTION__, $filter );
520 | 	}
521 | 
522 | 	$args = wp_parse_args( $args, array(
523 | 		'image_size' => 'thumbnail',
524 | 		) );
525 | 
526 | 	$ID = apply_filters( 'taxonomy-images-queried-term-image-id', 0 );
527 | 
528 | 	if ( empty( $ID ) ) {
529 | 		return array();
530 | 	}
531 | 
532 | 	$data = array();
533 | 
534 | 	if ( in_array( $args['image_size'], array( 'full', 'fullsize' ) ) ) {
535 | 		$src = wp_get_attachment_image_src( $ID, 'full' );
536 | 
537 | 		if ( isset( $src[0] ) ) {
538 | 			$data['url'] = $src[0];
539 | 		}
540 | 		if ( isset( $src[1] ) ) {
541 | 			$data['width'] = $src[1];
542 | 		}
543 | 		if ( isset( $src[2] ) ) {
544 | 			$data['height'] = $src[2];
545 | 		}
546 | 	}
547 | 	else {
548 | 		$data = image_get_intermediate_size( $ID, $args['image_size'] );
549 | 	}
550 | 
551 | 	if ( ! empty( $data ) ) {
552 | 		return $data;
553 | 	}
554 | 
555 | 	return array();
556 | }
557 | 


--------------------------------------------------------------------------------
/taxonomy-images.php:
--------------------------------------------------------------------------------
   1 | <?php
   2 | /*
   3 | Plugin Name:          Taxonomy Images
   4 | Plugin URI:           http://wordpress.mfields.org/plugins/taxonomy-images/
   5 | Description:          Associate images from your media library to categories, tags and custom taxonomies.
   6 | Version:              0.8.0
   7 | Author:               Michael Fields
   8 | Author URI:           http://wordpress.mfields.org/
   9 | License:              GNU General Public License v2 or later
  10 | License URI:          http://www.gnu.org/licenses/gpl-2.0.html
  11 | 
  12 | Copyright 2010-2011  Michael Fields  michael@mfields.org
  13 | 
  14 | This program is free software; you can redistribute it and/or modify
  15 | it under the terms of the GNU General Public License version 2 as published by
  16 | the Free Software Foundation.
  17 | 
  18 | This program is distributed in the hope that it will be useful,
  19 | but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 | GNU General Public License for more details.
  22 | 
  23 | You should have received a copy of the GNU General Public License
  24 | along with this program; if not, write to the Free Software
  25 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  26 | */
  27 | 
  28 | 
  29 | require_once( trailingslashit( dirname( __FILE__ ) ) . 'deprecated.php' );
  30 | require_once( trailingslashit( dirname( __FILE__ ) ) . 'public-filters.php' );
  31 | 
  32 | 
  33 | /**
  34 |  * Version Number.
  35 |  *
  36 |  * @return    string    The plugin's version number.
  37 |  * @access    private
  38 |  * @since     0.7
  39 |  * @alter     0.7.4
  40 |  */
  41 | function taxonomy_image_plugin_version() {
  42 | 	return '0.8.0';
  43 | }
  44 | 
  45 | 
  46 | /**
  47 |  * Get a url to a file in this plugin.
  48 |  *
  49 |  * @return    string
  50 |  * @access    private
  51 |  * @since     0.7
  52 |  */
  53 | function taxonomy_image_plugin_url( $file = '' ) {
  54 | 	static $path = '';
  55 | 	if ( empty( $path ) ) {
  56 | 		$path = plugin_dir_url( __FILE__ );
  57 | 	}
  58 | 	return $path . $file;
  59 | }
  60 | 
  61 | 
  62 | /**
  63 |  * Detail Image Size.
  64 |  *
  65 |  * @return    array     Configuration for the "detail" image size.
  66 |  * @access    private
  67 |  * @since     0.7
  68 |  */
  69 | function taxonomy_image_plugin_detail_image_size() {
  70 | 	return array(
  71 | 		'name' => 'detail',
  72 | 		'size' => array( 75, 75, true )
  73 | 	);
  74 | }
  75 | 
  76 | 
  77 | /**
  78 |  * Register custom image size with WordPress.
  79 |  *
  80 |  * @access    private
  81 |  * @since     2010-10-28
  82 |  */
  83 | function taxonomy_image_plugin_add_image_size() {
  84 | 	$detail = taxonomy_image_plugin_detail_image_size();
  85 | 	add_image_size(
  86 | 		$detail['name'],
  87 | 		$detail['size'][0],
  88 | 		$detail['size'][1],
  89 | 		$detail['size'][2]
  90 | 	);
  91 | }
  92 | add_action( 'init', 'taxonomy_image_plugin_add_image_size' );
  93 | 
  94 | 
  95 | /**
  96 |  * Load Plugin Text Domain.
  97 |  *
  98 |  * @access    private
  99 |  * @since     0.7.3
 100 |  */
 101 | function taxonomy_image_plugin_text_domain() {
 102 | 	load_plugin_textdomain( 'taxonomy-images', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
 103 | }
 104 | add_action( 'init', 'taxonomy_image_plugin_text_domain' );
 105 | 
 106 | 
 107 | /**
 108 |  * Modal Button.
 109 |  *
 110 |  * Create a button in the modal media window to associate the current image to the term.
 111 |  *
 112 |  * @param     array     Multidimensional array representing the images form.
 113 |  * @param     stdClass  WordPress post object.
 114 |  * @return    array     The image's form array with added button if modal window was accessed by this script.
 115 |  *
 116 |  * @access    private
 117 |  * @since     2010-10-28
 118 |  * @alter     0.7
 119 |  */
 120 | function taxonomy_image_plugin_modal_button( $fields, $post ) {
 121 | 	if ( isset( $fields['image-size'] ) && isset( $post->ID ) ) {
 122 | 		$image_id = (int) $post->ID;
 123 | 
 124 | 		$o = '<div class="taxonomy-image-modal-control" id="' . esc_attr( 'taxonomy-image-modal-control-' . $image_id ) . '">';
 125 | 
 126 | 		$o.= '<span class="button create-association">' . sprintf( esc_html__( 'Associate with %1$s', 'taxonomy-images' ), '<span class="term-name">' . esc_html__( 'this term', 'taxonomy-images' ) . '</span>' ) . '</span>';
 127 | 
 128 | 		$o.= '<span class="remove-association">' . sprintf( esc_html__( 'Remove association with %1$s', 'taxonomy-images' ), '<span class="term-name">' . esc_html__( 'this term', 'taxonomy-images' ) . '</span>' ) . '</span>';
 129 | 
 130 | 		$o.= '<input class="taxonomy-image-button-image-id" name="' . esc_attr( 'taxonomy-image-button-image-id-' . $image_id ) . '" type="hidden" value="' . esc_attr( $image_id ) . '" />';
 131 | 
 132 | 		$o.= '<input class="taxonomy-image-button-nonce-create" name="' . esc_attr( 'taxonomy-image-button-nonce-create-' . $image_id ) . '" type="hidden" value="' . esc_attr( wp_create_nonce( 'taxonomy-image-plugin-create-association' ) ) . '" />';
 133 | 
 134 | 		$o.= '<input class="taxonomy-image-button-nonce-remove" name="' . esc_attr( 'taxonomy-image-button-nonce-remove-' . $image_id ) . '" type="hidden" value="' . esc_attr( wp_create_nonce( 'taxonomy-image-plugin-remove-association' ) ) . '" />';
 135 | 
 136 | 		$o.= '</div>';
 137 | 
 138 | 		$fields['image-size']['extra_rows']['taxonomy-image-plugin-button']['html'] = $o;
 139 | 	}
 140 | 	return $fields;
 141 | }
 142 | add_filter( 'attachment_fields_to_edit', 'taxonomy_image_plugin_modal_button', 20, 2 );
 143 | 
 144 | 
 145 | /**
 146 |  * Get Image Source.
 147 |  *
 148 |  * Return a uri to a custom image size.
 149 |  *
 150 |  * If size doesn't exist, attempt to create a resized version.
 151 |  * The output of this function should be escaped before printing to the browser.
 152 |  *
 153 |  * @param     int       Image ID.
 154 |  * @return    string    URI of custom image on success; emtpy string otherwise.
 155 |  *
 156 |  * @access    private.
 157 |  * @since     2010-10-28
 158 |  */
 159 | function taxonomy_image_plugin_get_image_src( $id ) {
 160 | 	$detail = taxonomy_image_plugin_detail_image_size();
 161 | 
 162 | 	/* Return url to custom intermediate size if it exists. */
 163 | 	$img = image_get_intermediate_size( $id, $detail['name'] );
 164 | 	if ( isset( $img['url'] ) )
 165 | 		return $img['url'];
 166 | 
 167 | 	/* Detail image does not exist, attempt to create it. */
 168 | 	$wp_upload_dir = wp_upload_dir();
 169 | 	if ( isset( $wp_upload_dir['basedir'] ) ) {
 170 | 
 171 | 		/* Create path to original uploaded image. */
 172 | 		$path = trailingslashit( $wp_upload_dir['basedir'] ) . get_post_meta( $id, '_wp_attached_file', true );
 173 | 		if ( is_file( $path ) ) {
 174 | 
 175 | 			/* Attempt to create a new downsized version of the original image. */
 176 | 			$new = image_resize( $path,
 177 | 				$detail['size'][0],
 178 | 				$detail['size'][1],
 179 | 				$detail['size'][2]
 180 | 				);
 181 | 
 182 | 			/* Image creation successful. Generate and cache image metadata. Return url. */
 183 | 			if ( ! is_wp_error( $new ) ) {
 184 | 				$meta = wp_generate_attachment_metadata( $id, $path );
 185 | 				wp_update_attachment_metadata( $id, $meta );
 186 | 				$img = image_get_intermediate_size( $id, $detail['name'] );
 187 | 				if ( isset( $img['url'] ) ) {
 188 | 					return $img['url'];
 189 | 				}
 190 | 			}
 191 | 		}
 192 | 	}
 193 | 
 194 | 	/* Custom intermediate size cannot be created, try for thumbnail. */
 195 | 	$img = image_get_intermediate_size( $id, 'thumbnail' );
 196 | 	if ( isset( $img['url'] ) )
 197 | 		return $img['url'];
 198 | 
 199 | 	/* Thumbnail cannot be found, try fullsize. */
 200 | 	$url = wp_get_attachment_url( $id );
 201 | 	if ( ! empty( $url ) )
 202 | 		return $url;
 203 | 
 204 | 	/*
 205 | 	 * No image can be found.
 206 | 	 * This is most likely caused by a user deleting an attachment before deleting it's association with a taxonomy.
 207 | 	 * If we are in the administration panels:
 208 | 	 * - Delete the association.
 209 | 	 * - Return uri to default.png.
 210 | 	 */
 211 | 	if ( is_admin() ) {
 212 | 		$assoc = taxonomy_image_plugin_get_associations();
 213 | 		foreach ( $assoc as $term => $img ) {
 214 | 			if ( $img === $id ) {
 215 | 				unset( $assoc[$term] );
 216 | 			}
 217 | 		}
 218 | 		update_option( 'taxonomy_image_plugin', $assoc );
 219 | 		return taxonomy_image_plugin_url( 'default.png' );
 220 | 	}
 221 | 
 222 | 	/*
 223 | 	 * No image can be found.
 224 | 	 * Return path to blank-image.png.
 225 | 	 */
 226 | 	return taxonomy_image_plugin_url( 'blank.png' );
 227 | }
 228 | 
 229 | 
 230 | /**
 231 |  * Sanitize Associations.
 232 |  *
 233 |  * Ensures that all key/value pairs are positive integers.
 234 |  * This filter will discard all zero and negative values.
 235 |  *
 236 |  * @param     array     An array of term_taxonomy_id/attachment_id pairs.
 237 |  * @return    array     Sanitized version of parameter.
 238 |  *
 239 |  * @access    private
 240 |  */
 241 | function taxonomy_image_plugin_sanitize_associations( $associations ) {
 242 | 	$o = array();
 243 | 	foreach ( (array) $associations as $tt_id => $im_id ) {
 244 | 		$tt_id = absint( $tt_id );
 245 | 		$im_id = absint( $im_id );
 246 | 		if ( 0 < $tt_id && 0 < $im_id )
 247 | 			$o[$tt_id] = $im_id;
 248 | 	}
 249 | 	return $o;
 250 | }
 251 | 
 252 | 
 253 | /**
 254 |  * Sanitize Settings.
 255 |  *
 256 |  * This function is responsible for ensuring that
 257 |  * all values within the 'taxonomy_image_plugin_settings'
 258 |  * options are of the appropriate type.
 259 |  *
 260 |  * @param     array     Unknown.
 261 |  * @return    array     Multi-dimensional array of sanitized settings.
 262 |  *
 263 |  * @access    private
 264 |  * @since     0.7
 265 |  */
 266 | function taxonomy_image_plugin_settings_sanitize( $dirty ) {
 267 | 	$clean = array();
 268 | 	if ( isset( $dirty['taxonomies'] ) ) {
 269 | 		$taxonomies = get_taxonomies();
 270 | 		foreach ( (array) $dirty['taxonomies'] as $taxonomy ) {
 271 | 			if ( in_array( $taxonomy, $taxonomies ) )
 272 | 				$clean['taxonomies'][] = $taxonomy;
 273 | 		}
 274 | 	}
 275 | 
 276 | 	/* translators: Notice displayed on the custom administration page. */
 277 | 	$message = __( 'Image support for taxonomies successfully updated', 'taxonomy-images' );
 278 | 	if ( empty( $clean ) ) {
 279 | 		/* translators: Notice displayed on the custom administration page. */
 280 | 		$message = __( 'Image support has been disabled for all taxonomies.', 'taxonomy-images' );
 281 | 	}
 282 | 
 283 | 	add_settings_error( 'taxonomy_image_plugin_settings', 'taxonomies_updated', esc_html( $message ), 'updated' );
 284 | 
 285 | 	return $clean;
 286 | }
 287 | 
 288 | 
 289 | /**
 290 |  * Register settings with WordPress.
 291 |  *
 292 |  * This plugin will store to sets of settings in the
 293 |  * options table. The first is named 'taxonomy_image_plugin'
 294 |  * and stores the associations between terms and images. The
 295 |  * keys in this array represent the term_taxonomy_id of the
 296 |  * term while the value represents the ID of the image
 297 |  * attachment.
 298 |  *
 299 |  * The second setting is used to store everything else. As of
 300 |  * version 0.7 it has one key named 'taxonomies' whichi is a
 301 |  * flat array consisting of taxonomy names representing a
 302 |  * black-list of registered taxonomies. These taxonomies will
 303 |  * NOT be given an image UI.
 304 |  *
 305 |  * @access    private
 306 |  */
 307 | function taxonomy_image_plugin_register_settings() {
 308 | 	register_setting(
 309 | 		'taxonomy_image_plugin',
 310 | 		'taxonomy_image_plugin',
 311 | 		'taxonomy_image_plugin_sanitize_associations'
 312 | 	);
 313 | 	register_setting(
 314 | 		'taxonomy_image_plugin_settings',
 315 | 		'taxonomy_image_plugin_settings',
 316 | 		'taxonomy_image_plugin_settings_sanitize'
 317 | 	);
 318 | 	add_settings_section(
 319 | 		'taxonomy_image_plugin_settings',
 320 | 		esc_html__( 'Settings', 'taxonomy-images' ),
 321 | 		'__return_false',
 322 | 		'taxonomy_image_plugin_settings'
 323 | 	);
 324 | 	add_settings_field(
 325 | 		'taxonomy-images',
 326 | 		esc_html__( 'Taxonomies', 'taxonomy-images' ),
 327 | 		'taxonomy_image_plugin_control_taxonomies',
 328 | 		'taxonomy_image_plugin_settings',
 329 | 		'taxonomy_image_plugin_settings'
 330 | 	);
 331 | }
 332 | add_action( 'admin_init', 'taxonomy_image_plugin_register_settings' );
 333 | 
 334 | 
 335 | /**
 336 |  * Admin Menu.
 337 |  *
 338 |  * Create the admin menu link for the settings page.
 339 |  *
 340 |  * @access    private
 341 |  * @since     0.7
 342 |  */
 343 | function taxonomy_images_settings_menu() {
 344 | 	add_options_page(
 345 | 		esc_html__( 'Taxonomy Images', 'taxonomy-images' ), /* HTML <title> tag. */
 346 | 		esc_html__( 'Taxonomy Images', 'taxonomy-images' ), /* Link text in admin menu. */
 347 | 		'manage_options',
 348 | 		'taxonomy_image_plugin_settings',
 349 | 		'taxonomy_image_plugin_settings_page'
 350 | 	);
 351 | }
 352 | add_action( 'admin_menu', 'taxonomy_images_settings_menu' );
 353 | 
 354 | 
 355 | /**
 356 |  * Settings Page Template.
 357 |  *
 358 |  * This function in conjunction with others usei the WordPress
 359 |  * Settings API to create a settings page where users can adjust
 360 |  * the behaviour of this plugin. Please see the following functions
 361 |  * for more insight on the output generated by this function:
 362 |  *
 363 |  * taxonomy_image_plugin_control_taxonomies()
 364 |  *
 365 |  * @access    private
 366 |  * @since     0.7
 367 |  */
 368 | function taxonomy_image_plugin_settings_page() {
 369 | 	print "\n" . '<div class="wrap">';
 370 | 	screen_icon();
 371 | 
 372 | 	/* translators: Heading of the custom administration page. */
 373 | 	print "\n" . '<h2>' . esc_html__( 'Taxonomy Images Plugin Settings', 'taxonomy-images' ) . '</h2>';
 374 | 	print "\n" . '<div id="taxonomy-images">';
 375 | 	print "\n" . '<form action="options.php" method="post">';
 376 | 
 377 | 	settings_fields( 'taxonomy_image_plugin_settings' );
 378 | 	do_settings_sections( 'taxonomy_image_plugin_settings' );
 379 | 
 380 | 	/* translators: Button on the custom administration page. */
 381 | 	print "\n" . '<div class="button-holder"><input class="button-primary" name="submit" type="submit" value="' . esc_attr__( 'Save Changes', 'taxonomy-images' ) . '" /></div>';
 382 | 	print "\n" . '</div></form></div>';
 383 | }
 384 | 
 385 | 
 386 | /**
 387 |  * Taxonomy Checklist.
 388 |  *
 389 |  * @access    private
 390 |  */
 391 | function taxonomy_image_plugin_control_taxonomies() {
 392 | 	$settings = get_option( 'taxonomy_image_plugin_settings' );
 393 | 	$taxonomies = get_taxonomies( array(), 'objects' );
 394 | 	foreach ( (array) $taxonomies as $taxonomy ) {
 395 | 		if ( ! isset( $taxonomy->name ) )
 396 | 			continue;
 397 | 
 398 | 		if ( ! isset( $taxonomy->label ) )
 399 | 			continue;
 400 | 
 401 | 		if ( ! isset( $taxonomy->show_ui ) || empty( $taxonomy->show_ui ) )
 402 | 			continue;
 403 | 
 404 | 		$id = 'taxonomy-images-' . $taxonomy->name;
 405 | 
 406 | 		$checked = '';
 407 | 		if ( isset( $settings['taxonomies'] ) && in_array( $taxonomy->name, (array) $settings['taxonomies'] ) )
 408 | 			$checked = ' checked="checked"';
 409 | 
 410 | 		print "\n" . '<p><label for="' . esc_attr( $id ) . '">';
 411 | 		print '<input' . $checked . ' id="' . esc_attr( $id ) . '" type="checkbox" name="taxonomy_image_plugin_settings[taxonomies][]" value="' . esc_attr( $taxonomy->name ) . '">';
 412 | 		print ' ' . esc_html( $taxonomy->label ) . '</label></p>';
 413 | 	}
 414 | }
 415 | 
 416 | 
 417 | /**
 418 |  * JSON Respose.
 419 |  * Terminates script execution.
 420 |  *
 421 |  * @param     array     Associative array of values to be encoded in JSON.
 422 |  *
 423 |  * @access    private
 424 |  */
 425 | function taxonomy_image_plugin_json_response( $args ) {
 426 | 	/* translators: An ajax request has failed for an unknown reason. */
 427 | 	$response = wp_parse_args( $args, array(
 428 | 		'status' => 'bad',
 429 | 		'why'    => esc_html__( 'Unknown error encountered', 'taxonomy-images' )
 430 | 	) );
 431 | 	header( 'Content-type: application/jsonrequest' );
 432 | 	print json_encode( $response );
 433 | 	exit;
 434 | }
 435 | 
 436 | 
 437 | /**
 438 |  * Get Term Info.
 439 |  *
 440 |  * Returns term info by term_taxonomy_id.
 441 |  *
 442 |  * @param     int       term_taxonomy_id
 443 |  * @return    array     Keys: term_id (int) and taxonomy (string).
 444 |  *
 445 |  * @access    private
 446 |  */
 447 | function taxonomy_image_plugin_get_term_info( $tt_id ) {
 448 | 	static $cache = array();
 449 | 	if ( isset( $cache[$tt_id] ) ) {
 450 | 		return $cache[$tt_id];
 451 | 	}
 452 | 
 453 | 	global $wpdb;
 454 | 
 455 | 	$data = $wpdb->get_results( $wpdb->prepare( "SELECT term_id, taxonomy FROM $wpdb->term_taxonomy WHERE term_taxonomy_id = %d LIMIT 1", $tt_id ) );
 456 | 	if ( isset( $data[0]->term_id ) )
 457 | 		$cache[$tt_id]['term_id'] = absint( $data[0]->term_id );
 458 | 
 459 | 	if ( isset( $data[0]->taxonomy ) )
 460 | 		$cache[$tt_id]['taxonomy'] = sanitize_title_with_dashes( $data[0]->taxonomy );
 461 | 
 462 | 	if ( isset( $cache[$tt_id] ) )
 463 | 		return $cache[$tt_id];
 464 | 
 465 | 	return array();
 466 | }
 467 | 
 468 | 
 469 | /**
 470 |  * Check Taxonomy Permissions.
 471 |  *
 472 |  * Allows a permission check to be performed on a term
 473 |  * when all you know is the term_taxonomy_id.
 474 |  *
 475 |  * @param     int       term_taxonomy_id
 476 |  * @return    bool      True if user can edit terms, False if not.
 477 |  *
 478 |  * @access    private
 479 |  */
 480 | function taxonomy_image_plugin_check_permissions( $tt_id ) {
 481 | 	$data = taxonomy_image_plugin_get_term_info( $tt_id );
 482 | 	if ( ! isset( $data['taxonomy'] ) )
 483 | 		return false;
 484 | 
 485 | 	$taxonomy = get_taxonomy( $data['taxonomy'] );
 486 | 	if ( ! isset( $taxonomy->cap->edit_terms ) )
 487 | 		return false;
 488 | 
 489 | 	return current_user_can( $taxonomy->cap->edit_terms );
 490 | }
 491 | 
 492 | 
 493 | /**
 494 |  * Create an association.
 495 |  *
 496 |  * Callback for the wp_ajax_{$_GET['action']} hook.
 497 |  *
 498 |  * @access    private
 499 |  */
 500 | function taxonomy_image_plugin_create_association() {
 501 | 	if ( ! isset( $_POST['tt_id'] ) ) {
 502 | 		taxonomy_image_plugin_json_response( array(
 503 | 			'status' => 'bad',
 504 | 			'why'    => esc_html__( 'tt_id not sent', 'taxonomy-images' ),
 505 | 		) );
 506 | 	}
 507 | 
 508 | 	$tt_id = absint( $_POST['tt_id'] );
 509 | 	if ( empty( $tt_id ) ) {
 510 | 		taxonomy_image_plugin_json_response( array(
 511 | 			'status' => 'bad',
 512 | 			'why'    => esc_html__( 'tt_id is empty', 'taxonomy-images' ),
 513 | 		) );
 514 | 	}
 515 | 
 516 | 	if ( ! taxonomy_image_plugin_check_permissions( $tt_id ) ) {
 517 | 		taxonomy_image_plugin_json_response( array(
 518 | 			'status' => 'bad',
 519 | 			'why'    => esc_html__( 'You do not have the correct capability to manage this term', 'taxonomy-images' ),
 520 | 		) );
 521 | 	}
 522 | 
 523 | 	if ( ! isset( $_POST['wp_nonce'] ) ) {
 524 | 		taxonomy_image_plugin_json_response( array(
 525 | 			'status' => 'bad',
 526 | 			'why'    => esc_html__( 'No nonce included.', 'taxonomy-images' ),
 527 | 		) );
 528 | 	}
 529 | 
 530 | 	if ( ! wp_verify_nonce( $_POST['wp_nonce'], 'taxonomy-image-plugin-create-association' ) ) {
 531 | 		taxonomy_image_plugin_json_response( array(
 532 | 			'status' => 'bad',
 533 | 			'why'    => esc_html__( 'Nonce did not match', 'taxonomy-images' ),
 534 | 		) );
 535 | 	}
 536 | 
 537 | 	if ( ! isset( $_POST['attachment_id'] ) ) {
 538 | 		taxonomy_image_plugin_json_response( array(
 539 | 			'status' => 'bad',
 540 | 			'why'    => esc_html__( 'Image id not sent', 'taxonomy-images' )
 541 | 		) );
 542 | 	}
 543 | 
 544 | 	$image_id = absint( $_POST['attachment_id'] );
 545 | 	if ( empty( $image_id ) ) {
 546 | 		taxonomy_image_plugin_json_response( array(
 547 | 			'status' => 'bad',
 548 | 			'why'    => esc_html__( 'Image id is not a positive integer', 'taxonomy-images' )
 549 | 		) );
 550 | 	}
 551 | 
 552 | 	$assoc = taxonomy_image_plugin_get_associations();
 553 | 	$assoc[$tt_id] = $image_id;
 554 | 	if ( update_option( 'taxonomy_image_plugin', taxonomy_image_plugin_sanitize_associations( $assoc ) ) ) {
 555 | 		taxonomy_image_plugin_json_response( array(
 556 | 			'status' => 'good',
 557 | 			'why'    => esc_html__( 'Image successfully associated', 'taxonomy-images' ),
 558 | 			'attachment_thumb_src' => taxonomy_image_plugin_get_image_src( $image_id )
 559 | 		) );
 560 | 	}
 561 | 	else {
 562 | 		taxonomy_image_plugin_json_response( array(
 563 | 			'status' => 'bad',
 564 | 			'why'    => esc_html__( 'Association could not be created', 'taxonomy-images' )
 565 | 		) );
 566 | 	}
 567 | 
 568 | 	/* Don't know why, but something didn't work. */
 569 | 	taxonomy_image_plugin_json_response();
 570 | }
 571 | add_action( 'wp_ajax_taxonomy_image_create_association', 'taxonomy_image_plugin_create_association' );
 572 | 
 573 | 
 574 | /**
 575 |  * Remove an association.
 576 |  *
 577 |  * Removes an association from the setting stored in the database.
 578 |  * Print json encoded message and terminates script execution.
 579 |  *
 580 |  * @access    private
 581 |  */
 582 | function taxonomy_image_plugin_remove_association() {
 583 | 	if ( ! isset( $_POST['tt_id'] ) ) {
 584 | 		taxonomy_image_plugin_json_response( array(
 585 | 			'status' => 'bad',
 586 | 			'why'    => esc_html__( 'tt_id not sent', 'taxonomy-images' ),
 587 | 		) );
 588 | 	}
 589 | 
 590 | 	$tt_id = absint( $_POST['tt_id'] );
 591 | 	if ( empty( $tt_id ) ) {
 592 | 		taxonomy_image_plugin_json_response( array(
 593 | 			'status' => 'bad',
 594 | 			'why'    => esc_html__( 'tt_id is empty', 'taxonomy-images' ),
 595 | 		) );
 596 | 	}
 597 | 
 598 | 	if ( ! taxonomy_image_plugin_check_permissions( $tt_id ) ) {
 599 | 		taxonomy_image_plugin_json_response( array(
 600 | 			'status' => 'bad',
 601 | 			'why'    => esc_html__( 'You do not have the correct capability to manage this term', 'taxonomy-images' ),
 602 | 		) );
 603 | 	}
 604 | 
 605 | 	if ( ! isset( $_POST['wp_nonce'] ) ) {
 606 | 		taxonomy_image_plugin_json_response( array(
 607 | 			'status' => 'bad',
 608 | 			'why'    => esc_html__( 'No nonce included', 'taxonomy-images' ),
 609 | 		) );
 610 | 	}
 611 | 
 612 | 	if ( ! wp_verify_nonce( $_POST['wp_nonce'], 'taxonomy-image-plugin-remove-association') ) {
 613 | 		taxonomy_image_plugin_json_response( array(
 614 | 			'status' => 'bad',
 615 | 			'why'    => esc_html__( 'Nonce did not match', 'taxonomy-images' ),
 616 | 		) );
 617 | 	}
 618 | 
 619 | 	$assoc = taxonomy_image_plugin_get_associations();
 620 | 	if ( ! isset( $assoc[$tt_id] ) ) {
 621 | 		taxonomy_image_plugin_json_response( array(
 622 | 			'status' => 'good',
 623 | 			'why'    => esc_html__( 'Nothing to remove', 'taxonomy-images' )
 624 | 		) );
 625 | 	}
 626 | 
 627 | 	unset( $assoc[$tt_id] );
 628 | 
 629 | 	if ( update_option( 'taxonomy_image_plugin', $assoc ) ) {
 630 | 		taxonomy_image_plugin_json_response( array(
 631 | 			'status' => 'good',
 632 | 			'why'    => esc_html__( 'Association successfully removed', 'taxonomy-images' )
 633 | 		) );
 634 | 	}
 635 | 	else {
 636 | 		taxonomy_image_plugin_json_response( array(
 637 | 			'status' => 'bad',
 638 | 			'why'    => esc_html__( 'Association could not be removed', 'taxonomy-images' )
 639 | 		) );
 640 | 	}
 641 | 
 642 | 	/* Don't know why, but something didn't work. */
 643 | 	taxonomy_image_plugin_json_response();
 644 | }
 645 | add_action( 'wp_ajax_taxonomy_image_plugin_remove_association', 'taxonomy_image_plugin_remove_association' );
 646 | 
 647 | 
 648 | /**
 649 |  * Get a list of user-defined associations.
 650 |  * Associations are stored in the WordPress options table.
 651 |  *
 652 |  * @param     bool      Should WordPress query the database for the results
 653 |  * @return    array     List of associations. Key => taxonomy_term_id; Value => image_id
 654 |  *
 655 |  * @access    private
 656 |  */
 657 | function taxonomy_image_plugin_get_associations( $refresh = false ) {
 658 | 	static $associations = array();
 659 | 	if ( empty( $associations ) || $refresh )
 660 | 		$associations = taxonomy_image_plugin_sanitize_associations( get_option( 'taxonomy_image_plugin' ) );
 661 | 
 662 | 	return $associations;
 663 | }
 664 | add_action( 'init', 'taxonomy_image_plugin_get_associations' );
 665 | 
 666 | 
 667 | /**
 668 |  * Dynamically create hooks for each taxonomy.
 669 |  *
 670 |  * Adds hooks for each taxonomy that the user has given
 671 |  * an image interface to via settings page. These hooks
 672 |  * enable the image interface on wp-admin/edit-tags.php.
 673 |  *
 674 |  * @access    private
 675 |  * @since     0.4.3
 676 |  * @alter     0.7
 677 |  */
 678 | function taxonomy_image_plugin_add_dynamic_hooks() {
 679 | 	$settings = get_option( 'taxonomy_image_plugin_settings' );
 680 | 	if ( ! isset( $settings['taxonomies'] ) )
 681 | 		return;
 682 | 
 683 | 	foreach ( $settings['taxonomies'] as $taxonomy ) {
 684 | 		add_filter( 'manage_' . $taxonomy . '_custom_column', 'taxonomy_image_plugin_taxonomy_rows', 15, 3 );
 685 | 		add_filter( 'manage_edit-' . $taxonomy . '_columns',  'taxonomy_image_plugin_taxonomy_columns' );
 686 | 		add_action( $taxonomy . '_edit_form_fields',          'taxonomy_image_plugin_edit_tag_form', 10, 2 );
 687 | 	}
 688 | }
 689 | add_action( 'admin_init', 'taxonomy_image_plugin_add_dynamic_hooks' );
 690 | 
 691 | 
 692 | /**
 693 |  * Edit Term Columns.
 694 |  *
 695 |  * Insert a new column on wp-admin/edit-tags.php.
 696 |  *
 697 |  * @see taxonomy_image_plugin_add_dynamic_hooks()
 698 |  *
 699 |  * @param     array     A list of columns.
 700 |  * @return    array     List of columns with "Images" inserted after the checkbox.
 701 |  *
 702 |  * @access    private
 703 |  * @since     0.4.3
 704 |  */
 705 | function taxonomy_image_plugin_taxonomy_columns( $original_columns ) {
 706 | 	$new_columns = $original_columns;
 707 | 	array_splice( $new_columns, 1 );
 708 | 	$new_columns['taxonomy_image_plugin'] = esc_html__( 'Image', 'taxonomy-images' );
 709 | 	return array_merge( $new_columns, $original_columns );
 710 | }
 711 | 
 712 | 
 713 | /**
 714 |  * Edit Term Rows.
 715 |  *
 716 |  * Create image control for each term row of wp-admin/edit-tags.php.
 717 |  *
 718 |  * @see taxonomy_image_plugin_add_dynamic_hooks()
 719 |  *
 720 |  * @param     string    Row.
 721 |  * @param     string    Name of the current column.
 722 |  * @param     int       Term ID.
 723 |  * @return    string    @see taxonomy_image_plugin_control_image()
 724 |  *
 725 |  * @access    private
 726 |  * @since     2010-11-08
 727 |  */
 728 | function taxonomy_image_plugin_taxonomy_rows( $row, $column_name, $term_id ) {
 729 | 	if ( 'taxonomy_image_plugin' === $column_name ) {
 730 | 		global $taxonomy;
 731 | 		return $row . taxonomy_image_plugin_control_image( $term_id, $taxonomy );
 732 | 	}
 733 | 	return $row;
 734 | }
 735 | 
 736 | 
 737 | /**
 738 |  * Edit Term Control.
 739 |  *
 740 |  * Create image control for wp-admin/edit-tag-form.php.
 741 |  * Hooked into the '{$taxonomy}_edit_form_fields' action.
 742 |  *
 743 |  * @param     stdClass  Term object.
 744 |  * @param     string    Taxonomy slug.
 745 |  *
 746 |  * @access    private
 747 |  * @since     2010-11-08
 748 |  */
 749 | function taxonomy_image_plugin_edit_tag_form( $term, $taxonomy ) {
 750 | 	$taxonomy = get_taxonomy( $taxonomy );
 751 | 	$name = __( 'term', 'taxonomy-images' );
 752 | 	if ( isset( $taxonomy->labels->singular_name ) )
 753 | 		$name = strtolower( $taxonomy->labels->singular_name );
 754 | 	?>
 755 | 	<tr class="form-field hide-if-no-js">
 756 | 		<th scope="row" valign="top"><label for="description"><?php print esc_html__( 'Image', 'taxonomy-images' ) ?></label></th>
 757 | 		<td>
 758 | 			<?php print taxonomy_image_plugin_control_image( $term->term_id, $taxonomy->name ); ?>
 759 | 			<div class="clear"></div>
 760 | 			<span class="description"><?php printf( esc_html__( 'Associate an image from your media library to this %1$s.', 'taxonomy-images' ), esc_html( $name ) ); ?></span>
 761 | 		</td>
 762 | 	</tr>
 763 | 	<?php
 764 | }
 765 | 
 766 | /**
 767 |  * Image Control.
 768 |  *
 769 |  * Creates all image controls on edit-tags.php.
 770 |  *
 771 |  * @todo      Remove rel tag from link... will need to adjust js to accomodate.
 772 |  * @since     0.7
 773 |  * @access    private
 774 |  */
 775 | function taxonomy_image_plugin_control_image( $term_id, $taxonomy ) {
 776 | 
 777 | 	$term = get_term( $term_id, $taxonomy );
 778 | 
 779 | 	$tt_id = 0;
 780 | 	if ( isset( $term->term_taxonomy_id ) )
 781 | 		$tt_id = (int) $term->term_taxonomy_id;
 782 | 
 783 | 	$taxonomy = get_taxonomy( $taxonomy );
 784 | 
 785 | 	$name = esc_html__( 'term', 'taxonomy-images' );
 786 | 	if ( isset( $taxonomy->labels->singular_name ) )
 787 | 		$name = strtolower( $taxonomy->labels->singular_name );
 788 | 
 789 | 	$hide = ' hide';
 790 | 	$attachment_id = 0;
 791 | 	$associations = taxonomy_image_plugin_get_associations();
 792 | 	if ( isset( $associations[ $tt_id ] ) ) {
 793 | 		$attachment_id = (int) $associations[ $tt_id ];
 794 | 		$hide = '';
 795 | 	}
 796 | 
 797 | 	$img = taxonomy_image_plugin_get_image_src( $attachment_id );
 798 | 
 799 | 	$term = get_term( $term_id, $taxonomy->name );
 800 | 
 801 | 	$o = "\n" . '<div id="' . esc_attr( 'taxonomy-image-control-' . $tt_id ) . '" class="taxonomy-image-control hide-if-no-js">';
 802 | 	$o.= "\n" . '<a class="thickbox taxonomy-image-thumbnail" href="' . esc_url( admin_url( 'media-upload.php' ) . '?type=image&tab=library&post_id=0&TB_iframe=true' ) . '" title="' . esc_attr( sprintf( __( 'Associate an image with the %1$s named &#8220;%2$s&#8221;.', 'taxonomy-images' ), $name, $term->name ) ) . '"><img id="' . esc_attr( 'taxonomy_image_plugin_' . $tt_id ) . '" src="' . esc_url( $img ) . '" alt="" /></a>';
 803 | 	$o.= "\n" . '<a class="control upload thickbox" href="' . esc_url( admin_url( 'media-upload.php' ) . '?type=image&tab=type&post_id=0&TB_iframe=true' ) . '" title="' . esc_attr( sprintf( __( 'Upload a new image for this %s.', 'taxonomy-images' ), $name ) ) . '">' . esc_html__( 'Upload.', 'taxonomy-images' ) . '</a>';
 804 | 	$o.= "\n" . '<a class="control remove' . $hide . '" href="#" id="' . esc_attr( 'remove-' . $tt_id ) . '" rel="' . esc_attr( $tt_id ) . '" title="' . esc_attr( sprintf( __( 'Remove image from this %s.', 'taxonomy-images' ), $name ) ) . '">' . esc_html__( 'Delete', 'taxonomy-images' ) . '</a>';
 805 | 	$o.= "\n" . '<input type="hidden" class="tt_id" name="' . esc_attr( 'tt_id-' . $tt_id ) . '" value="' . esc_attr( $tt_id ) . '" />';
 806 | 
 807 | 	$o.= "\n" . '<input type="hidden" class="image_id" name="' . esc_attr( 'image_id-' . $tt_id ) . '" value="' . esc_attr( $attachment_id ) . '" />';
 808 | 
 809 | 	if ( isset( $term->name ) && isset( $term->slug ) )
 810 | 		$o.= "\n" . '<input type="hidden" class="term_name" name="' . esc_attr( 'term_name-' . $term->slug ) . '" value="' . esc_attr( $term->name ) . '" />';
 811 | 
 812 | 	$o.= "\n" . '</div>';
 813 | 	return $o;
 814 | }
 815 | 
 816 | 
 817 | /**
 818 |  * Custom javascript for modal media box.
 819 |  *
 820 |  * This script need to be added to all instance of the media upload box.
 821 |  *
 822 |  * @access    private
 823 |  */
 824 | function taxonomy_image_plugin_media_upload_popup_js() {
 825 | 	wp_enqueue_script(
 826 | 		'taxonomy-images-media-upload-popup',
 827 | 		taxonomy_image_plugin_url( 'media-upload-popup.js' ),
 828 | 		array( 'jquery' ),
 829 | 		taxonomy_image_plugin_version()
 830 | 	);
 831 | 	wp_localize_script( 'taxonomy-images-media-upload-popup', 'TaxonomyImagesModal', array (
 832 | 		'termBefore'  => esc_html__( '&#8220;', 'taxonomy-images' ),
 833 | 		'termAfter'   => esc_html__( '&#8221;', 'taxonomy-images' ),
 834 | 		'associating' => esc_html__( 'Associating &#8230;', 'taxonomy-images' ),
 835 | 		'success'     => esc_html__( 'Successfully Associated', 'taxonomy-images' ),
 836 | 		'removing'    => esc_html__( 'Removing &#8230;', 'taxonomy-images' ),
 837 | 		'removed'     => esc_html__( 'Successfully Removed', 'taxonomy-images' )
 838 | 	) );
 839 | }
 840 | add_action( 'admin_print_scripts-media-upload-popup', 'taxonomy_image_plugin_media_upload_popup_js' );
 841 | 
 842 | 
 843 | /**
 844 |  * Custom javascript for wp-admin/edit-tags.php.
 845 |  *
 846 |  * @access    private
 847 |  */
 848 | function taxonomy_image_plugin_edit_tags_js() {
 849 | 	if ( false == taxonomy_image_plugin_is_screen_active() )
 850 | 		return;
 851 | 
 852 | 	wp_enqueue_script(
 853 | 		'taxonomy-image-plugin-edit-tags',
 854 | 		taxonomy_image_plugin_url( 'edit-tags.js' ),
 855 | 		array( 'jquery', 'thickbox' ),
 856 | 		taxonomy_image_plugin_version()
 857 | 	);
 858 | 	wp_localize_script( 'taxonomy-image-plugin-edit-tags', 'taxonomyImagesPlugin', array (
 859 | 		'nonce'    => wp_create_nonce( 'taxonomy-image-plugin-remove-association' ),
 860 | 		'img_src'  => taxonomy_image_plugin_url( 'default.png' ),
 861 | 		'tt_id'    => 0,
 862 | 		'image_id' => 0,
 863 | 	) );
 864 | }
 865 | add_action( 'admin_print_scripts-edit-tags.php', 'taxonomy_image_plugin_edit_tags_js' );
 866 | 
 867 | 
 868 | /**
 869 |  * Custom styles.
 870 |  *
 871 |  * @since     0.7
 872 |  * @access    private
 873 |  */
 874 | function taxonomy_image_plugin_css_admin() {
 875 | 	if ( false == taxonomy_image_plugin_is_screen_active() && 'admin_print_styles-media-upload-popup' != current_filter() )
 876 | 		return;
 877 | 
 878 | 	wp_enqueue_style(
 879 | 		'taxonomy-image-plugin-edit-tags',
 880 | 		taxonomy_image_plugin_url( 'admin.css' ),
 881 | 		array(),
 882 | 		taxonomy_image_plugin_version(),
 883 | 		'screen'
 884 | 	);
 885 | }
 886 | add_action( 'admin_print_styles-edit-tags.php', 'taxonomy_image_plugin_css_admin' );
 887 | add_action( 'admin_print_styles-media-upload-popup', 'taxonomy_image_plugin_css_admin' );
 888 | 
 889 | 
 890 | /**
 891 |  * Thickbox styles.
 892 |  *
 893 |  * @since     0.7
 894 |  * @access    private
 895 |  */
 896 | function taxonomy_image_plugin_css_thickbox() {
 897 | 	if ( false == taxonomy_image_plugin_is_screen_active() )
 898 | 		return;
 899 | 
 900 | 	wp_enqueue_style( 'thickbox' );
 901 | }
 902 | add_action( 'admin_print_styles-edit-tags.php', 'taxonomy_image_plugin_css_thickbox' );
 903 | 
 904 | 
 905 | /**
 906 |  * Public Styles.
 907 |  *
 908 |  * Prints custom css to all public pages. If you do not
 909 |  * wish to have these styles included for you, please
 910 |  * insert the following code into your theme's functions.php
 911 |  * file:
 912 |  *
 913 |  * add_filter( 'taxonomy-images-disable-public-css', '__return_true' );
 914 |  *
 915 |  * @since     0.7
 916 |  * @access    private
 917 |  */
 918 | function taxonomy_image_plugin_css_public() {
 919 | 	if ( apply_filters( 'taxonomy-images-disable-public-css', false ) )
 920 | 		return;
 921 | 
 922 | 	wp_enqueue_style(
 923 | 		'taxonomy-image-plugin-public',
 924 | 		taxonomy_image_plugin_url( 'style.css' ),
 925 | 		array(),
 926 | 		taxonomy_image_plugin_version(),
 927 | 		'screen'
 928 | 	);
 929 | }
 930 | add_action( 'wp_print_styles', 'taxonomy_image_plugin_css_public' );
 931 | 
 932 | 
 933 | /**
 934 |  * Activation.
 935 |  *
 936 |  * Two entries in the options table will created when this
 937 |  * plugin is activated in the event that they do not exist.
 938 |  *
 939 |  * 'taxonomy_image_plugin' (array) A flat list of all assocaitions
 940 |  * made by this plugin. Keys are integers representing the
 941 |  * term_taxonomy_id of terms. Values are integers representing the
 942 |  * ID property of an image attachment.
 943 |  *
 944 |  * 'taxonomy_image_plugin_settings' (array) A multi-dimensional array
 945 |  * of user-defined settings. As of version 0.7, only one key is used:
 946 |  * 'taxonomies' which is a whitelist of registered taxonomies having ui
 947 |  * that support the custom image ui provided by this plugin.
 948 |  *
 949 |  * @access    private
 950 |  * @alter     0.7
 951 |  */
 952 | function taxonomy_image_plugin_activate() {
 953 | 	$associations = get_option( 'taxonomy_image_plugin' );
 954 | 	if ( false === $associations )
 955 | 		add_option( 'taxonomy_image_plugin', array() );
 956 | 
 957 | 	$settings = get_option( 'taxonomy_image_plugin_settings' );
 958 | 	if ( false === $settings ) {
 959 | 		add_option( 'taxonomy_image_plugin_settings', array(
 960 | 			'taxonomies' => array()
 961 | 		) );
 962 | 	}
 963 | }
 964 | register_activation_hook( __FILE__, 'taxonomy_image_plugin_activate' );
 965 | 
 966 | 
 967 | /**
 968 |  * Is Screen Active?
 969 |  *
 970 |  * @return    bool
 971 |  *
 972 |  * @access    private
 973 |  * @since     0.7
 974 |  */
 975 | function taxonomy_image_plugin_is_screen_active() {
 976 | 	$screen = get_current_screen();
 977 | 	if ( ! isset( $screen->taxonomy ) )
 978 | 		return false;
 979 | 
 980 | 	$settings = get_option( 'taxonomy_image_plugin_settings' );
 981 | 	if ( ! isset( $settings['taxonomies'] ) )
 982 | 		return false;
 983 | 
 984 | 	if ( in_array( $screen->taxonomy, $settings['taxonomies'] ) )
 985 | 		return true;
 986 | 
 987 | 	return false;
 988 | }
 989 | 
 990 | 
 991 | /**
 992 |  * Cache Images
 993 |  *
 994 |  * Sets the WordPress object cache for all term images
 995 |  * associated to the posts in the provided array. This
 996 |  * function has been created to minimize queries when
 997 |  * using this plugins get_the_terms() style function.
 998 |  *
 999 |  * @param     array          Post objects.
1000 |  *
1001 |  * @access    private
1002 |  * @since     1.1
1003 |  */
1004 | function taxonomy_image_plugin_cache_images( $posts ) {
1005 | 	$assoc = taxonomy_image_plugin_get_associations();
1006 | 	if ( empty( $assoc ) )
1007 | 		return;
1008 | 
1009 | 	$tt_ids = array();
1010 | 	foreach ( (array) $posts as $post ) {
1011 | 		if ( ! isset( $post->ID ) || ! isset( $post->post_type ) )
1012 | 			continue;
1013 | 
1014 | 		$taxonomies = get_object_taxonomies( $post->post_type );
1015 | 		if ( empty( $taxonomies ) )
1016 | 			continue;
1017 | 
1018 | 		foreach ( $taxonomies as $taxonomy ) {
1019 | 			$the_terms = get_the_terms( $post->ID, $taxonomy );
1020 | 			foreach ( (array) $the_terms as $term ) {
1021 | 				if ( ! isset( $term->term_taxonomy_id ) ) {
1022 | 					continue;
1023 | 				}
1024 | 				$tt_ids[] = $term->term_taxonomy_id;
1025 | 			}
1026 | 		}
1027 | 	}
1028 | 	$tt_ids = array_filter( array_unique( $tt_ids ) );
1029 | 
1030 | 	$image_ids = array();
1031 | 	foreach ( $tt_ids as $tt_id ) {
1032 | 		if ( ! isset( $assoc[$tt_id] ) )
1033 | 			continue;
1034 | 
1035 | 		if ( in_array( $assoc[$tt_id], $image_ids ) )
1036 | 			continue;
1037 | 
1038 | 		$image_ids[] = $assoc[$tt_id];
1039 | 	}
1040 | 
1041 | 	if ( empty( $image_ids ) )
1042 | 		return;
1043 | 
1044 | 	$images = get_posts( array(
1045 | 		'include'   => $image_ids,
1046 | 		'post_type' => 'attachment'
1047 | 	) );
1048 | }
1049 | 
1050 | 
1051 | /**
1052 |  * Cache Images
1053 |  *
1054 |  * Cache all term images associated with posts in
1055 |  * the main WordPress query.
1056 |  *
1057 |  * @param     array          Post objects.
1058 |  *
1059 |  * @access    private
1060 |  * @since     0.7
1061 |  */
1062 | function taxonomy_image_plugin_cache_queried_images() {
1063 | 	global $posts;
1064 | 	taxonomy_image_plugin_cache_images( $posts );
1065 | }
1066 | add_action( 'template_redirect', 'taxonomy_image_plugin_cache_queried_images' );
1067 | 
1068 | 
1069 | /**
1070 |  * Check Taxonomy
1071 |  *
1072 |  * Wrapper for WordPress core functions taxonomy_exists().
1073 |  * In the event that an unregistered taxonomy is passed a
1074 |  * E_USER_NOTICE will be generated.
1075 |  *
1076 |  * @param     string         Taxonomy name as registered with WordPress.
1077 |  * @param     string         Name of the current function or filter.
1078 |  * @return    bool           True if taxonomy exists, False if not.
1079 |  *
1080 |  * @access    private
1081 |  * @since     0.7
1082 |  */
1083 | function taxonomy_image_plugin_check_taxonomy( $taxonomy, $filter ) {
1084 | 	if ( ! taxonomy_exists( $taxonomy ) ) {
1085 | 		trigger_error( sprintf( esc_html__( 'The %1$s argument for %2$s is set to %3$s which is not a registered taxonomy. Please check the spelling and update the argument.', 'taxonomy-images' ),
1086 | 		'<var>' . esc_html__( 'taxonomy', 'taxonomy-images' ) . '</var>',
1087 | 		'<code>' . esc_html( $filter ) . '</code>',
1088 | 		'<strong>' . esc_html( $taxonomy ) . '</strong>'
1089 | 		) );
1090 | 		return false;
1091 | 	}
1092 | 
1093 | 	$settings = get_option( 'taxonomy_image_plugin_settings' );
1094 | 
1095 | 	if ( ! isset( $settings['taxonomies'] ) ) {
1096 | 		trigger_error( sprintf( esc_html__( 'No taxonomies have image support. %1$s', 'taxonomy-images' ), taxonomy_images_plugin_settings_page_link() ) );
1097 | 		return false;
1098 | 	}
1099 | 
1100 | 	if ( ! in_array( $taxonomy, (array) $settings['taxonomies'] ) ) {
1101 | 		trigger_error( sprintf( esc_html__( 'The %1$s taxonomy does not have image support. %2$s', 'taxonomy-images' ),
1102 | 			'<strong>' . esc_html( $taxonomy ) . '</strong>',
1103 | 			taxonomy_images_plugin_settings_page_link()
1104 | 		) );
1105 | 		return false;
1106 | 	}
1107 | 
1108 | 	return true;
1109 | }
1110 | 
1111 | 
1112 | /**
1113 |  * Please Use Filter.
1114 |  *
1115 |  * Report to user that they are directly calling a function
1116 |  * instead of using supported filters. A E_USER_NOTICE will
1117 |  * be generated.
1118 |  *
1119 |  * @param     string         Name of function called.
1120 |  * @param     string         Name of filter to use instead.
1121 |  *
1122 |  * @access    private
1123 |  * @since     0.7
1124 |  */
1125 | function taxonomy_image_plugin_please_use_filter( $function, $filter ) {
1126 | 	trigger_error( sprintf( esc_html__( 'The %1$s has been called directly. Please use the %2$s filter instead.', 'taxonomy-images' ),
1127 | 		'<code>' . esc_html( $function . '()' ) . '</code>',
1128 | 		'<code>' . esc_html( $filter ) . '</code>'
1129 | 	) );
1130 | }
1131 | 
1132 | 
1133 | /**
1134 |  * Plugin Meta Links.
1135 |  *
1136 |  * Add a link to this plugin's setting page when it
1137 |  * displays in the table on wp-admin/plugins.php.
1138 |  *
1139 |  * @param     array          List of links.
1140 |  * @param     string         Current plugin being displayed in plugins.php.
1141 |  * @return    array          Potentially modified list of links.
1142 |  *
1143 |  * @access    private
1144 |  * @since     0.7
1145 |  */
1146 | function taxonomy_images_plugin_row_meta( $links, $file ) {
1147 | 	static $plugin_name = '';
1148 | 
1149 | 	if ( empty( $plugin_name ) )
1150 | 		$plugin_name = plugin_basename( __FILE__ );
1151 | 
1152 | 	if ( $plugin_name != $file )
1153 | 		return $links;
1154 | 
1155 | 	$link = taxonomy_images_plugin_settings_page_link( __( 'Settings', 'taxonomy-images' ) );
1156 | 	if ( ! empty( $link ) )
1157 | 		$links[] = $link;
1158 | 
1159 | 	$links[] = '<a href="http://wordpress.mfields.org/donate/">' . __( 'Donate', 'taxonomy-images' ) . '</a>';
1160 | 
1161 | 	return $links;
1162 | }
1163 | add_filter( 'plugin_row_meta', 'taxonomy_images_plugin_row_meta', 10, 2 );
1164 | 
1165 | 
1166 | /**
1167 |  * Settings Page Link.
1168 |  *
1169 |  * @param     array     Localized link text.
1170 |  * @return    string    HTML link to settings page.
1171 |  *
1172 |  * @access    private
1173 |  * @since     0.7
1174 |  */
1175 | function taxonomy_images_plugin_settings_page_link( $link_text = '' ) {
1176 | 	if ( empty( $link_text ) )
1177 | 		$link_text = __( 'Manage Settings', 'taxonomy-images' );
1178 | 
1179 | 	$link = '';
1180 | 	if ( current_user_can( 'manage_options' ) )
1181 | 		$link = '<a href="' . esc_url( add_query_arg( array( 'page' => 'taxonomy_image_plugin_settings' ), admin_url( 'options-general.php' ) ) ) . '">' . esc_html( $link_text ) . '</a>';
1182 | 
1183 | 	return $link;
1184 | }
1185 | 


--------------------------------------------------------------------------------