{"id":36936,"date":"2015-06-15T20:05:32","date_gmt":"2015-06-15T20:05:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/sf-taxonomy-thumbnail\/"},"modified":"2016-05-30T18:34:53","modified_gmt":"2016-05-30T18:34:53","slug":"sf-taxonomy-thumbnail","status":"publish","type":"plugin","link":"https:\/\/gl.wordpress.org\/plugins\/sf-taxonomy-thumbnail\/","author":7167877,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3","stable_tag":"trunk","tested":"4.5.33","requires":"3.5","requires_php":"","requires_plugins":"","header_name":"SF Taxonomy Thumbnail","header_author":"Gr\u00e9gory Viguier","header_description":"","assets_banners_color":"d2b5b8","last_updated":"2016-05-30 18:34:53","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.screenfeed.fr\/plugin-wp\/taxonomy-thumbnail\/","header_author_uri":"https:\/\/www.screenfeed.fr\/greg\/","rating":5,"author_block_rating":0,"active_installs":4000,"downloads":50807,"num_ratings":10,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"":"

If you use Meta for Taxonomies<\/em> plugin, you will need this version when WordPress 4.4 comes out.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"11"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1181360","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1181360","resolution":"256x256","location":"assets"},"icon.svg":{"filename":"icon.svg","revision":"1181360","resolution":"","location":"assets"}},"assets_banners":{"banner-772x250-rtl.jpg":{"filename":"banner-772x250-rtl.jpg","revision":"1286672","resolution":"772x250","location":"assets"},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1286672","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1181380","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1181380","resolution":"2","location":"assets"}},"screenshots":{"1":"Create a new category an assign a thumbnail.","2":"Change or remove the thumbnail from the category."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,2985,133,91,1326],"plugin_category":[50,57],"plugin_contributors":[78484],"plugin_business_model":[],"class_list":["post-36936","plugin","type-plugin","status-publish","hentry","plugin_tags-category","plugin_tags-dev","plugin_tags-image","plugin_tags-taxonomy","plugin_tags-thumbnail","plugin_category-media","plugin_category-taxonomy","plugin_contributors-greglone","plugin_committers-greglone"],"banners":{"banner":"https:\/\/ps.w.org\/sf-taxonomy-thumbnail\/assets\/banner-772x250.jpg?rev=1286672","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/sf-taxonomy-thumbnail\/assets\/icon.svg?rev=1181360","icon":"https:\/\/ps.w.org\/sf-taxonomy-thumbnail\/assets\/icon.svg?rev=1181360","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/sf-taxonomy-thumbnail\/assets\/screenshot-1.png?rev=1181380","caption":"Create a new category an assign a thumbnail."},{"src":"https:\/\/ps.w.org\/sf-taxonomy-thumbnail\/assets\/screenshot-2.png?rev=1181380","caption":"Change or remove the thumbnail from the category."}],"raw_content":"\n

This plugin is meant for developers, it allows to attach a thumbnail to taxonomy terms.<\/p>\n\n

UI for setting the thumbnails<\/h4>\n\n

The thumbnail can be added on term creation or later on the term edition page.
\nThe terms list has a column displaying the current thumbnail (so far, no specific action here).
\nThe plugin uses the \"new\" media window (the one used since WP 3.5), not the old thickbox.
\nI made some extra efforts to enhance accessibility. I'm not an a11y expert but the UI is not only a \"Add thumbnail\" button. For instance, the new wp.a11y.speak()<\/code> is used when available. Please give me feedback if you think it can be improved.
\nWorks with or without JavaScript.
\nIf JavaScript is enabled, thumbnails are set via ajax in the term edition window, no need to update the term.
\nBy default, the UI is displayed for all public taxonomies, but this can be filtered that way:<\/p>\n\n

add_filter( 'sftth_taxonomies', 'my_taxonomies_with_thumbnail' );\n\nfunction my_taxonomies_with_thumbnail( $taxonomies ) {\n    unset( $taxonomies['post_tag'] );\n    $taxonomies['my_custom_tax'] = 'my_custom_tax';\n    return $taxonomies;\n}\n<\/code><\/pre>\n\n
Template tags<\/h4>\n\n
Find them in inc\/template-tags.php<\/code>.
\nImportant note: for WP 4.4+, these functions use term_id<\/code>. For WP < 4.4, they use term_taxonomy_id<\/code>.<\/strong>
\nI tried to mimic the post thumbnail functions:<\/p>\n\n
    \n
  1. get_term_thumbnail_id( $term_id )<\/code>: Retrieve term thumbnail ID.<\/li>\n
  2. has_term_thumbnail( $term_id )<\/code>: Check if a term has a thumbnail attached to it.<\/li>\n
  3. the_term_thumbnail( $term_id, $size = 'post-thumbnail', $attr = '' )<\/code>: Display the term thumbnail.<\/li>\n
  4. get_term_thumbnail( $term_id, $size = 'post-thumbnail', $attr = '' )<\/code>: Retrieve the term thumbnail.<\/li>\n
  5. set_term_thumbnail( $term_id, $thumbnail_id )<\/code>: Set a term thumbnail.<\/li>\n
  6. delete_term_thumbnail( $term_id )<\/code>: Detach a thumbnail from a term.<\/li>\n<\/ol>\n\n
    Store the data<\/h4>\n\n
    From WordPress 4.4, the term metas API is used.
    \nBelow WordPress 4.4, there are two ways to store the thumbnail IDs:<\/p>\n\n
      \n
    1. Use term metas with the plugin Meta for Taxonomies<\/a>.<\/li>\n
    2. Use an option (an array association of term_taxonomy_id<\/code> => thumbnail_id<\/code> integers). The option name can be customized by defining the constant SFTTH_OPTION_NAME<\/code> in wp-config.php<\/code>.<\/li>\n<\/ol>\n\n
      Get terms<\/h4>\n\n
      Use get_terms()<\/code> with a specific parameter to retrieve only terms with a thumbnail:<\/p>\n\n
      $terms = get_terms( array(\n    'with_thumbnail' => true,\n) );\n<\/code><\/pre>\n\n
      From WordPress 4.4, you can also use a small helper to build your meta query:<\/p>\n\n
      $terms = get_terms( array(\n    'meta_query' => array(\n        'relation' => 'AND',\n        array(\n            \/\/ Any meta query.\n        ),\n        sftth_meta_query(),\n    ),\n) );\n<\/code><\/pre>\n\n
      Below WordPress 4.4, if you use the plugin Meta for Taxonomies<\/em>, you should always cache thumbnails.
      \nWhen using 'with_thumbnail' => false<\/code> you will retrieve all terms, even those without a thumbnail, but the thumbnails will be cached, saving calls to the database later:<\/p>\n\n
      $terms = get_terms( array(\n    'with_thumbnail' => false,\n) );\n<\/code><\/pre>\n\n
      Uninstall<\/h4>\n\n
      When uninstalling the plugin, you can decide to not delete the thumbnails, simply define a constant in wp-config.php<\/code>:<\/p>\n\n
      define( 'SFTTH_KEEP_DATA', true );\n<\/code><\/pre>\n\n
      Translations<\/h4>\n\n