PHPackages humanmade/wp-term-images - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. humanmade/wp-term-images ActiveWordpress-plugin[File & Storage](/categories/file-storage) humanmade/wp-term-images ======================== Images for categories, tags, and other taxonomy terms 2.2.0(1mo ago)62.6k↓47.9%GPL-2.0-or-laterPHPPHP >=8.2CI passing Since Nov 9Pushed 1mo ago1 watchersCompare [ Source](https://github.com/humanmade/wp-term-images)[ Packagist](https://packagist.org/packages/humanmade/wp-term-images)[ Docs](https://github.com/humanmade/wp-term-images)[ RSS](/packages/humanmade-wp-term-images/feed)WikiDiscussions main Synced 2w ago READMEChangelog (5)Dependencies (3)Versions (16)Used By (0) WP Term Images ============== [](#wp-term-images) [Forked from stuttter/wp-term-images](https://github.com/stuttter/wp-term-images) 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 taxonomy terms. Installation ============ [](#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. FAQ === [](#faq) ### Does this plugin depend on any others? [](#does-this-plugin-depend-on-any-others) Not since WordPress 4.4. ### Does this create new database tables? [](#does-this-create-new-database-tables) No. There are no new database tables with this plugin. ### Does this modify existing database tables? [](#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? [](#how-do-i-get-the-image-for-a-term) With WordPress's `get_term_meta()` function ``` // 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]; if ( ! empty( $image ) ) { echo ''; } ``` ### How do I bind a term's image to an Image block? [](#how-do-i-bind-a-terms-image-to-an-image-block) For WordPress 6.7+, plugin registers a [Block Bindings](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) source `wp-term-images/term-image` that can bind properties on the core Image block to properties of the image assigned to a term. Rendering is done on frontend render; the editor shows that the image is bound but as of 7.0 does not preview any term image properties. The source answers whichever Image attribute you bind: AttributeValue`url`The attachment URL, **required** in order for the image to display.`alt`The attachment alt text.`title`The attachment title.`id`The attachment ID. Updates the `wp-image-{id}` class only; it does not change `src`, so `url` must be bound for the image to display.The term is taken from the `termId` arg when given. When the `termId` argument is not provided, the binding will use the associated image when on a taxonomy archive for a term that has an image assigned. Optional args: `termId` (defaults to the queried term) and `size` (image size for `url`, defaults to `full`). When `url` is bound, the plugin also adds the `wp-image-{id}` class and computes responsive `srcset`/`sizes` for the term's image, so the bound image renders with the same responsive markup as a natively-inserted one. Block Bindings replace scalar attributes only, so this is done in a `render_block_core/image` filter rather than through the binding itself. **Post content** — pin a specific term: ``` ``` **Template** — bind to the current term on an archive (no `termId`): ``` ``` Local Environment ----------------- [](#local-environment) This project uses [wp-env](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/) to run a lightweight, containerized WordPress instance at [localhost:3003](http://localhost:3003) for testing purposes. The default username for the localhost environment is `admin`, with the password `password`. These commands can be used to interact with the environment: CommandPurpose`npm run env:start`Start the local environment at `npm run env:stop`Turn off the local environment`npm run env:cli -- wp ...`Run WP-CLI commands within the environment`npm run env:logs`Open (and tail) the error logs for the application‡`npm run env:db`Open the database in the mysql command line`npm run env:destroy`Fully destroy the local environment (deletes container database)‡ This command deliberately filters out GET/OPTIONS/HEAD/POST/PUT access log entries Release Process --------------- [](#release-process) Note This plugin is currently distributed via Composer as `humanmade/wp-term-images`, not via the plugins repository. Merges to `main` automatically [build](https://github.com/humanmade/wp-term-images/actions/workflows/build-release-branch.yml) to the `release` branch. A project may track the `release` branch using [Composer](https://getcomposer.org/) to pull in the latest built beta version. Commits on the `release` branch may be tagged for installation via [Packagist](https://packagist.org/packages/humanmade/wp-term-images) and marked as releases in GitHub for manual download, using a manually-dispatched ["Tag and Release" GH Actions workflow](https://github.com/humanmade/wp-term-images/actions/workflows/tag-and-release.yml). To tag a new release: 1. Choose the target version number using [semantic versioning](https://semver.org/). 2. Check out a `prepare-v#.#.#` branch. 3. Bump the `Version` in the [wp-term-images.php](./wp-term-images.php) PHPDoc header. 4. Update the changelog entries in [readme.txt](./readme.txt). 5. Open a pull request titled "Prepare release v#.#.#". 6. Review and merge the "Prepare release" pull request. 7. Wait for the `release` branch to [update](https://github.com/humanmade/wp-term-images/actions/workflows/build-release-branch.yml) with the build that includes the new version number. 8. On the ["Tag and Release" GH Action page](https://github.com/humanmade/wp-term-images/actions/workflows/tag-and-release.yml): - Click "Run workflow" in the `workflow_dispatch` banner. - Fill out the "Version tag" field with your target version number. This must match the `Version` in `wp-term-images.php`. Use the format `v#.#.#`. - Click "Run workflow" to apply the specified tag to the `release` branch. Once the workflow completes, the new version is [tagged](https://github.com/humanmade/wp-term-images/tags) and listed in [releases](https://github.com/humanmade/wp-term-images/releases). ### Where can I get support? [](#where-can-i-get-support) - Basic: - Priority: ### Can I contribute? [](#can-i-contribute) Yes, please! The number of users needing more robust taxonomy visuals is growing fast. Having an easy-to-use UI and powerful set of functions is critical to managing complex WordPress installations. If this is your thing, please help us out! ### Health Score 57 — FairBetter than 98% of packages Maintenance91 Actively maintained with recent releases Popularity25 Limited adoption so far Community13 Small or concentrated contributor base Maturity83 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~432 days Recently: every ~395 days Total 10 Last Release 43d ago Major Versions 0.3.1 → 1.0.02017-01-17 1.0.1 → 2.0.12022-03-10 PHP version history (3 changes)0.1.0PHP >=5.2 1.0.1PHP >=5.6 2.1.0PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/77dbeefb7745010589603f2ffc6ff310d8f700b58e08d52af190744c43342526?d=identicon)[roborourke](/maintainers/roborourke) --- Top Contributors [![JJJ](https://avatars.githubusercontent.com/u/88951?v=4)](https://github.com/JJJ "JJJ (37 commits)")[![kadamwhite](https://avatars.githubusercontent.com/u/442115?v=4)](https://github.com/kadamwhite "kadamwhite (24 commits)")[![pamprn09](https://avatars.githubusercontent.com/u/55361215?v=4)](https://github.com/pamprn09 "pamprn09 (10 commits)")[![Rayhatron](https://avatars.githubusercontent.com/u/14850570?v=4)](https://github.com/Rayhatron "Rayhatron (8 commits)")[![stevegrunwell](https://avatars.githubusercontent.com/u/233836?v=4)](https://github.com/stevegrunwell "stevegrunwell (2 commits)")[![mayukojpn](https://avatars.githubusercontent.com/u/1886443?v=4)](https://github.com/mayukojpn "mayukojpn (1 commits)") ### Embed Badge ![Health badge](/badges/humanmade-wp-term-images/health.svg) ``` [![Health](https://phpackages.com/badges/humanmade-wp-term-images/health.svg)](https://phpackages.com/packages/humanmade-wp-term-images) ``` ### Alternatives [helsingborg-stad/municipio A bootstrap theme for creating municipality sites. 4028.6k10](/packages/helsingborg-stad-municipio)[october/rain October Rain Library 1601.7M103](/packages/october-rain)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45844.8k1](/packages/pressbooks-pressbooks)[elgg/elgg Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications. 1.7k17.3k100](/packages/elgg-elgg)[mediawiki/maps Adds various mapping features to MediaWiki 85155.1k3](/packages/mediawiki-maps)[civicrm/civicrm-drupal-8 Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 20256.6k4](/packages/civicrm-civicrm-drupal-8) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)