/perception

A Wordpress plugin to detect broad sets of objects in your media library images, from flowers, animals, or transportation to thousands of other object categories commonly found within images.

Primary LanguagePHP

perception

A Wordpress Plugin which classifies Media Library images by detecting individual objects and faces within images using Google Cloud Vision API.

Features

Detects broad sets of categories within an image, which range from modes of transportation to animals, popular product logos, popular natural and man-made structures, topical entities like celebrities, or news events.

Working Demo

Requirements

  • Wordpress >= 4.7
  • Composer

Important Notes

Please note that Google Cloud Vision API is a commercial service and while it's free for first 1000 units/month but you will be charged for any request after that. See their pricing here.

To better understand their pricing table, here is the list of the features we use in this plugin:

  • Label Detection
  • Landmark Detection
  • Logo Detection
  • Web Detection

Set up your project

  1. In the Cloud Platform Console, go to the Manage resources page and select or create a new project. Link
  2. Enable billing for your project. Link
  3. Enable the Cloud Vision API. Link

Authentication

For using this plugin, You need to provide a JSON file which contains your Project ID and Key. By following the steps below you can obtain them.

  1. In Cloud Platform Console, navigate to the Create service account key page.
  2. From the Service account dropdown, select New service account.
  3. Input a name into the Service account name form field.
  4. From the Role dropdown, select Project > Owner.
  5. Click the Create button. A JSON file that contains your key downloads to your computer.

Keep the JSON file on your computer, you will need it during the plugin installation.

Contributing

Contributions are welcome. Create a pull request to get started.

Issues

Please report any issues here.