Grégory Viguier

<p>This plugin is meant for developers, it allows to attach a thumbnail to taxonomy terms.</p>
<h4>UI for setting the thumbnails</h4>
<p>The thumbnail can be added on term creation or later on the term edition page.<br />
The terms list has a column displaying the current thumbnail (so far, no specific action here).<br />
The plugin uses the “new” media window (the one used since WP 3.5), not the old thickbox.<br />
I 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 <code>wp.a11y.speak()</code> is used when available. Please give me feedback if you think it can be improved.<br />
Works with or without JavaScript.<br />
If JavaScript is enabled, thumbnails are set via ajax in the term edition window, no need to update the term.<br />
By default, the UI is displayed for all public taxonomies, but this can be filtered that way:</p>
<pre><code>add_filter( 'sftth_taxonomies', 'my_taxonomies_with_thumbnail' );

function my_taxonomies_with_thumbnail( $taxonomies ) {
    unset( $taxonomies['post_tag'] );
    $taxonomies['my_custom_tax'] = 'my_custom_tax';
    return $taxonomies;
}
</code></pre>
<h4>Template tags</h4>
<p>Find them in <code>inc/template-tags.php</code>.<br />
<strong>Important note: for WP 4.4+, these functions use <code>term_id</code>. For WP < 4.4, they use <code>term_taxonomy_id</code>.</strong><br />
I tried to mimic the post thumbnail functions:</p>
<ol>
<li><code>get_term_thumbnail_id( $term_id )</code>: Retrieve term thumbnail ID.</li>
<li><code>has_term_thumbnail( $term_id )</code>: Check if a term has a thumbnail attached to it.</li>
<li><code>the_term_thumbnail( $term_id, $size = 'post-thumbnail', $attr = '' )</code>: Display the term thumbnail.</li>
<li><code>get_term_thumbnail( $term_id, $size = 'post-thumbnail', $attr = '' )</code>: Retrieve the term thumbnail.</li>
<li><code>set_term_thumbnail( $term_id, $thumbnail_id )</code>: Set a term thumbnail.</li>
<li><code>delete_term_thumbnail( $term_id )</code>: Detach a thumbnail from a term.</li>
</ol>
<h4>Store the data</h4>
<p>From WordPress 4.4, the term metas API is used.<br />
Below WordPress 4.4, there are two ways to store the thumbnail IDs:</p>
<ol>
<li>Use term metas with the plugin <a href="https://wordpress.org/plugins/meta-for-taxonomies/" rel="ugc">Meta for Taxonomies</a>.</li>
<li>Use an option (an array association of <code>term_taxonomy_id</code> => <code>thumbnail_id</code> integers). The option name can be customized by defining the constant <code>SFTTH_OPTION_NAME</code> in <code>wp-config.php</code>.</li>
</ol>
<h4>Get terms</h4>
<p>Use <code>get_terms()</code> with a specific parameter to retrieve only terms with a thumbnail:</p>
<pre><code>$terms = get_terms( array(
    'with_thumbnail' => true,
) );
</code></pre>
<p>From WordPress 4.4, you can also use a small helper to build your meta query:</p>
<pre><code>$terms = get_terms( array(
    'meta_query' => array(
        'relation' => 'AND',
        array(
            // Any meta query.
        ),
        sftth_meta_query(),
    ),
) );
</code></pre>
<p>Below WordPress 4.4, if you use the plugin <em>Meta for Taxonomies</em>, you should always cache thumbnails.<br />
When using <code>'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>
<pre><code>$terms = get_terms( array(
    'with_thumbnail' => false,
) );
</code></pre>
<h4>Uninstall</h4>
<p>When uninstalling the plugin, you can decide to not delete the thumbnails, simply define a constant in <code>wp-config.php</code>:</p>
<pre><code>define( 'SFTTH_KEEP_DATA', true );
</code></pre>
<h4>Translations</h4>
<ul>
<li>US English</li>
<li>French</li>
</ul>
<h4>Requirements</h4>
<p>Should work starting from WP 3.5, but tested only in WP 4.2.2+ so far.</p>
<h4>Credits</h4>
<p>Photo used for the banner by <a href="https://www.flickr.com/photos/n1colas/2598073727/" rel="nofollow ugc">Nicolas Janik</a> (<a href="https://creativecommons.org/licenses/by/2.0/" rel="nofollow ugc">CC BY 2.0</a>).</p>


Taxonomy Thumbnail

Does the work well

So easy to use, writing this review takes longer than using and understanding the plugin.
*****

I needed that, it existed.

Fulvio Notarstefano

<blockquote>
<p>PHP Console allows you to handle PHP errors & exceptions, dump variables, execute PHP code remotely and many other things using <a href="https://chrome.google.com/webstore/detail/php-console/nfhmhhlpfleoednkpnnnkolmclajemef" rel="nofollow ugc">Google Chrome extension PHP Console</a> and <a href="https://github.com/barbushin/php-console" rel="nofollow ugc">PHP Console server library</a>.</p>
</blockquote>
<p>This implementation of PHP Console is a handy tool to make it easier to test on the fly any WordPress specific function or class (including those introduced by your active theme and plugins!) from a terminal and inspect results, catch errors and warnings with complete call stack trace straight from the Chrome JavaScript console. In other words, besides debugging, you can execute PHP or WordPress-specific PHP code straight from the terminal and print PHP variables in Chrome Dev Tools JavaScript console along with your normal JavaScript debugging and testing. Keep everything in one place, without leaving the browser to check for your logs or writing temporary PHP test code on a PHP file and refresh your browser page.</p>
<p>Note: PHP version 5.6.0 or above is required to use this plugin.</p>
<p>For support and pull requests, please refer to <a href="https://github.com/unfulvio/wp-php-console" rel="nofollow ugc">WP PHP Console GitHub repo</a> and read the instructions there – thank you.</p>
<h3>Usage</h3>
<p>After you entered WP PHP Plugin password, your browser address bar should show a yellow “key” icon, which, if clicked, will prompt for the password you have set earlier.<br />
The “key” icon will change into a “terminal” icon, click on it to open the PHP Console eval & options form.</p>
<p>After entering the correct password, you can use the Eval Terminal in the PHP Console eval & options form and run any PHP code from it, including WordPress’s own functions: enter one or more lines of PHP code in the black Eval terminal screen, press Ctrl+Enter and see the result in Chrome Dev Tools JavaScript console.<br />
The result includes the output, the return value and the net server execution time.</p>
<p>In your PHP code on the Server, you can call PHP Console debug statements like <code>PC::debug( $var, $tag )</code> to display PHP variables in the JavaScript console and optionally filter selected tags through the PHP Console eval & options form opened from the address bar in your browser.</p>
<p>In the JavaScript console you will see printed any `PC::debug()“ information, PHP errors, warnings, notices with optional stack trace, which will be useful to debug your plugin or theme.</p>


WP PHP Console

Great tool for debugging wordpress plugins. Use it all the time!

Great plugin for debugging

this is what I wanted, does what it should for me

great tool

This plugin is very useful to debug php variable!

And show me stack ! 

Really Thank you !

Thank you very much!

As soon as I realized that Chrome extension is off in incognito mode by default and enabled it, I could enter password and got it to work immediately.

Great work

An implementation of PHP Console as a WordPress plugin. Use Chrome Dev Tools to debug your WordPress installation!

Taxonomy Thumbnail vs WP PHP Console