Fabio Cicerchia

<p>This script is useful during the development of WordPress, because will extend with a set of functions.</p>
<h3>Usage</h3>
<p>class <code>WP_Dev_Utilities</code>:</p>
<ul>
<li>_debug() – A function to print variable only if the user logged as administrator</li>
<li>_retrieve_user_data() – Retrive user data informations only if user is logged in</li>
<li>count_num_pages_post($id) – Returns the number of pages of a post</li>
<li>get_current_execution_time($precision = 3) – Get the current execution time</li>
<li>get_logged_username() – Returns the name of the user logged on</li>
<li>get_post_content_from_id($id) – Return the content of the post from his id</li>
<li>get_post_content_from_permalink($permalink) – Return the contents of the post permalink</li>
<li>get_post_id_from_permalink($permalink) – Return the id of the post permalink</li>
<li>is_administrator() – Check if logged user has the administrator privileges</li>
<li>get_web_browser($shortname = false, $uppercase = false) – Returns the user’s browser name</li>
<li>get_web_server($uppercase = false) – Returns the web server is use</li>
<li>get_wp_version() – Get the current wordpress version</li>
<li>get_tag_slug($title) – Get the tag slug from tag title</li>
<li>get_current_tag_slug($title) – Get the tag slug from the current tag title</li>
</ul>


WP Development Utilities

Extends the template tags with more functions that are very useful.

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.
*****

WP Development Utilities vs Taxonomy Thumbnail