Taghound Media Tagger

Contributors: jplhomer
Tags: media gallery, tagging, images, deep learning, neural network, admin
Requires at least: 3.9
Requires PHP: 5.5
Tested up to: 4.9.1
Stable tag: 2.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Automatically tag and search images in your media library using Clarifai's object recognition API.

Description

Automatically tag and search images in your media library using Clarifai's object recognition API. Using advances in deep learning, Clarifai leverages convoluted neural networks to analyze an image and return predictions of the contents of that image.

Typically, your images will be tagged with simple indicators like:

one person
no people
happy
man/woman
outdoors
tree

Taghound Media Tagger takes these predictions and turns them into WordPress tags. This enables you to immediately search for images you've added to your media library by the contents of the image and not by the title or description you have manually entered.

Taghound Media Tagger lets you tag new images in addition to a backlog of older images you added before installing the plugin!

Features

Automatically tag images in your media gallery with predicted contents
Search for the contents of images using the Media Gallery search input
Filter your media gallery by a specific tag
Tag existing images in your media library with the click of a button

Coming Soon

We're always looking to improve Taghound Media Tagger. Here's what is on the roadmap:

Tag videos in addition to photos

Github

This plugin is open-source and available on Github. Please consider contributing to the plugin if you find bugs or have a feature you'd like to see implemented:

https://github.com/jplhomer/taghound-media-tagger

Website

http://jplhomer.org/projects/taghound-media-tagger/

Art

Special thanks to Kevin Fish for his work on the TagHound logo and banner!

Installation

NOTE: You must have PHP 5.5 or greater installed on your server to activate the plugin. Ask your web host about this if you are unsure.
Upload 'taghound-media-tagger' to the '/wp-content/plugins/' directory
Activate the plugin through the 'Plugins' menu in WordPress
Visit the Clarifai Developer Portal and create a free or paid account
Create an application with Clarifai, and copy the API Key from the developer portal
Visit the Taghound settings page under Settings
Paste in the API Key from step 4 and click "Save Changes"
On the same page, click the checkbox "Enable for all new Images" to have Taghound Media Tagger begin tagging new images!

Frequently Asked Questions

Q. How do my images get analyzed by Clarifai?

A. Taghound Media Tagger sends each of your images over HTTPS to Clarifai after they've been uploaded to your media gallery.

Q. What does Clarifai do with my images?

A. Clarifai processes your images and returns a list of associated keywords. Additionally, Clarifai stores images to further train its models and increase the accuracy of future responses. Clarifai does not share your images with third parties.

Q. Does this plugin process images that already exist in my media library?

A. Yes! Visit the Settings > Taghound page and use the Bulk Tagger tool.

Q. What if an image gets tagged with something I don't like?

A. You may untag the image by clicking the 'X'. This is similar to how you would remove a tag from a post.

Q. Can I use this plugin with other 3rd party plugins like Media Library Assistant?

A. Yes! We've provided a hook for you to choose where to store the tags. Pass a function that returns the slug of the taxonomy you'd like to use to tmt_tag_taxonomy inside your theme's functions.php file.

See the documentation here.

We've also tested this with a couple popular media management plugins:

Media Library Assistant uses the attachment_tag slug
Enhanced Media Library uses the media_category slug

Note that the default user interface for Taghound's tag manipulation will be hidden when you've chosen an alternate tag taxonomy.

Screenshots

1. Tags are automatically applied to images when added to the media library

2. Tags are searchable from within the media library

3. Tags are searchable from within the Insert Media modal window when editing a post, too

4. Filter media items by a specific tag when using the list view of the media library

Changelog

2.0.2

Fixes bug where server would time out during upload-only bulk tagging events
Fixes visual bug introduced in tag picker in WordPress 4.9

2.0.1

Minor updates to the Readme and required PHP version.

2.0.0

FEATURE: Supports v2 of the Clarifai API! You will need to generate an API token to continue using the product.
FEATURE: Run the bulk tagger in upload-only mode.
Removes support for checking your usage stats in WordPress. Clarifai no longer supports this.

1.2.0

FEATURE: Adds the tmt_tag_taxonomy filter to allow users to customize the taxonomy used to store tags

1.1.1

Show more detailed error message during Bulk Tagging failure

1.1.0

FEATURE: A bulk tagger tags existing images in library
FEATURE: Under the hood, sends URL to image assets instead of uploading images individually
FEATURE: Moves Taghound settings to a dedicated screen

1.0.4

BUGFIX: Adds media browser support back to < WordPress 4.7

1.0.3

Removes cruft added to last build.

1.0.2

Updates admin UI to support WordPress 4.7
Adds a minimum required PHP version of 5.5.

1.0.1

FEATURE: See Clarifai API usage data under Media settings.

1.0.0

Taghound Media Tagger.

Upgrade Notice

2.0.0

This version supports the Clarifai v2 API, since v1 is now deprecated. You will need to create an API token to continue using Taghound!

Uncaught TypeError: Cannot read property ‘results’ of null

I get the following error when I attempt to begin the tagging process:

Uncaught TypeError: Cannot read property 'results' of null
    at Object.success (tmt-admin.js:56)
    at i (load-scripts.php?c=0&load[]=jquery-core,jquery-migrate,jquery-ui-core,jquery-ui-widget,jquery-ui-position,utils,suggest,jquery-ui-menu,wp-a11y,jquery-ui-aut&load[]=ocomplete,tags-suggest,underscore,moxiejs,plupload&ver=4.9.4:2)
    at Object.fireWith [as resolveWith] (load-scripts.php?c=0&load[]=jquery-core,jquery-migrate,jquery-ui-core,jquery-ui-widget,jquery-ui-position,utils,suggest,jquery-ui-menu,wp-a11y,jquery-ui-aut&load[]=ocomplete,tags-suggest,underscore,moxiejs,plupload&ver=4.9.4:2)
    at y (load-scripts.php?c=0&load[]=jquery-core,jquery-migrate,jquery-ui-core,jquery-ui-widget,jquery-ui-position,utils,suggest,jquery-ui-menu,wp-a11y,jquery-ui-aut&load[]=ocomplete,tags-suggest,underscore,moxiejs,plupload&ver=4.9.4:4)
    at XMLHttpRequest.c (load-scripts.php?c=0&load[]=jquery-core,jquery-migrate,jquery-ui-core,jquery-ui-widget,jquery-ui-position,utils,suggest,jquery-ui-menu,wp-a11y,jquery-ui-aut&load[]=ocomplete,tags-suggest,underscore,moxiejs,plupload&ver=4.9.4:4)

Selecting “My website is not publicly accessible” works until I get:

Uncaught TypeError: Cannot read property 'map' of undefined
    at Object.success (tmt-admin.js:56)
    at i (load-scripts.php:2)
    at Object.fireWith [as resolveWith] (load-scripts.php:2)
    at y (load-scripts.php:4)
    at XMLHttpRequest.c (load-scripts.php:4)`

Tagging is now stuck after 83 images.

WordPress 4.9.4 | PHP 7.1.15 | Apache/2.4.29 (Unix) mod_hive/6.6 OpenSSL/1.0.1e-fips mod_fastcgi/2.4.6 | MySQL 5.6.36-82.1-log

3rd Party Plugin	Slug to Override
Media Library Assistant	`attachment_tag`
Enhanced Media Library	`media_category`

jplhomer / taghound-media-tagger Goto Github PK