Skip to content
readme.txt 4.21 KiB
Newer Older
John James Jacoby's avatar
John James Jacoby committed
=== WP Term Images ===
John James Jacoby's avatar
John James Jacoby committed
Contributors:      johnjamesjacoby, stuttter
Tags:              taxonomy, term, meta, metadata, image, images
John James Jacoby's avatar
John James Jacoby committed
Requires at least: 4.4
John James Jacoby's avatar
John James Jacoby committed
Tested up to:      4.8
Stable tag:        1.0.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html
Donate link:       https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=9Q4F4EL5YJ62J
John James Jacoby's avatar
John James Jacoby committed

== Description ==

Images for categories, tags, and other taxonomy terms

WP Term Images allows users to assign images to any visible category, tag, or taxonomy term using the media library, providing a customized look for their taxonomies.

= Dependencies =

Not since WordPress 4.4.

Install the [WP Term Meta](https://wordpress.org/plugins/wp-term-meta/ "Metadata, for taxonomy terms.") plugin if you're on an earlier version.
John James Jacoby's avatar
John James Jacoby committed

= Also checkout =

* [WP Chosen](https://wordpress.org/plugins/wp-chosen/ "Make long, unwieldy select boxes much more user-friendly.")
* [WP Pretty Filters](https://wordpress.org/plugins/wp-pretty-filters/ "Makes post filters better match what's already in Media & Attachments.")
* [WP Event Calendar](https://wordpress.org/plugins/wp-event-calendar/ "The best way to manage events in WordPress.")
* [WP Media Categories](https://wordpress.org/plugins/wp-media-categories/ "Add categories to media & attachments.")
* [WP Term Order](https://wordpress.org/plugins/wp-term-order/ "Sort taxonomy terms, your way.")
* [WP Term Authors](https://wordpress.org/plugins/wp-term-authors/ "Authors for categories, tags, and other taxonomy terms.")
John James Jacoby's avatar
John James Jacoby committed
* [WP Term Colors](https://wordpress.org/plugins/wp-term-colors/ "Pretty colors for categories, tags, and other taxonomy terms.")
John James Jacoby's avatar
John James Jacoby committed
* [WP Term Icons](https://wordpress.org/plugins/wp-term-icons/ "Pretty icons for categories, tags, and other taxonomy terms.")
* [WP Term Visibility](https://wordpress.org/plugins/wp-term-visibility/ "Visibilities for categories, tags, and other taxonomy terms.")
* [WP User Activity](https://wordpress.org/plugins/wp-user-activity/ "The best way to log activity in WordPress.")
* [WP User Avatars](https://wordpress.org/plugins/wp-user-avatars/ "Allow users to upload avatars or choose them from your media library.")
* [WP User Groups](https://wordpress.org/plugins/wp-user-groups/ "Group users together with taxonomies & terms.")
* [WP User Profiles](https://wordpress.org/plugins/wp-user-profiles/ "A sophisticated way to edit users in WordPress.")

== Screenshots ==

1. Category Images

== Installation ==

* Download and install using the built in WordPress plugin installer.
* Activate in the "Plugins" area of your admin by clicking the "Activate" link.
* No further setup or configuration is necessary.

== Frequently Asked Questions ==

= Does this plugin depend on any others? =

Not since WordPress 4.4.

Install the [WP Term Meta](https://wordpress.org/plugins/wp-term-meta/ "Metadata, for taxonomy terms.") plugin if you're on an earlier version.
John James Jacoby's avatar
John James Jacoby committed

= Does this create new database tables? =

No. There are no new database tables with this plugin.

= Does this modify existing database tables? =

No. All of WordPress's core database tables remain untouched.

= How do I get the image for a term? =
John James Jacoby's avatar
John James Jacoby committed

With WordPress's `get_term_meta()` function

`
David Ryan's avatar
David Ryan committed
// image id is stored as term meta
$image_id = get_term_meta( 7, 'image', true );

// image data stored in array, second argument is which image size to retrieve
$image_data = wp_get_attachment_image_src( $image_id, 'full' );

// image url is the first item in the array (aka 0)
$image = $image_data[0];
John James Jacoby's avatar
John James Jacoby committed

if ( ! empty( $image ) ) {
David Ryan's avatar
David Ryan committed
    echo '<img src="' . esc_url( $image ) . '" />';
John James Jacoby's avatar
John James Jacoby committed
}
`

= Where can I get support? =

John James Jacoby's avatar
John James Jacoby committed
* Basic: https://wordpress.org/support/plugin/wp-term-images/
* Priority: https://chat.flox.io/support/channels/wp-term-images/
John James Jacoby's avatar
John James Jacoby committed

= Where can I find documentation? =

http://github.com/stuttter/wp-term-images/

== Changelog ==

John James Jacoby's avatar
John James Jacoby committed
= [1.0.0] - 2017-01-16 =
* Stability!
* Fix text domains
* Simplify some JavaScript
* Handle more JavaScript edge-cases

John James Jacoby's avatar
John James Jacoby committed
= [0.3.1] - 2016-07-13 =
* Fix regular edits

= [0.3.0] - 2016-05-27 =
John James Jacoby's avatar
John James Jacoby committed
* Fix quick-edits
* Update WP Term Meta UI dependency to 0.1.9

John James Jacoby's avatar
John James Jacoby committed
= [0.2.0] - 2016-01-07 =
John James Jacoby's avatar
John James Jacoby committed
* Fix new-term form action hi-jacking
* Update WP Term Meta UI dependency to 0.1.4

John James Jacoby's avatar
John James Jacoby committed
= [0.1.0] - 2015-11-09 =
John James Jacoby's avatar
John James Jacoby committed
* Initial release