IMDb Connector

Description

IMDb Connector is a simple plugin that lets you easily access the IMDb.com database through the API provided by omdbapi.com and get details for a specific movie or series.

IMPORTANT: The API provided by omdbapi.com has gone private and requires an API key which has to be paid for on a monthly basis (between $1 USD and $10 USD). This is why IMDb Connector now, unfortunately, depends on donations from a handful of users to keep the plugin free and make it function properly. Read more about the idea to keep IMDb Connector free for most users on the “Installation” page.

So far, the plugin comes with the following features:

  • Widgets that lets you display the movie details within your sidebar,
  • PHP functions that allows theme/plugin developers to parse information for a particular movie easily,
  • Shortcodes which you can use to display one or more details about a movie inside your post or page,
  • and a settings page that lets you (de)activate features and customise the way IMDb Connector works.

If you have any other ideas for features, please don’t hesitate to submit them by sending me an email and I’ll try my best to implement it in the next version.

Screenshots

  • The plugin's settings page.
  • The standard widget displayed in a sidebar.
  • The widget configuration on the admin interface.

Installation

How to install

  1. Install IMDb Connector either through WordPress’ native plugin installer found under Plugins > Install or copy the imdb-connector folder into the /wp-content/plugins/ directory of your WordPress installation.
  2. Make sure the folder /cache/ in the plugin’s directory is writable (CHMOD 755).
  3. Activate the plugin in the plugin section of your admin interface.
  4. Go to Settings > IMDb Connector to customise the plugin as desired.

Obtain an API key

Why do I need one?

IMDb Connector has stopped working since May 2017. This is because the unofficial OMDb API that the plugin uses to fetch movie data from IMDb.com has gone private and now requires an API key. The API keys cost $1 USD, $5 USD or $10 USD per month, depending on how often the API is being used. IMDb Connector can work with the monthly $1 USD API key.

What can I do?

IMDb Connector was meant to be a free plugin and should also be free in the future. However, this only works through donations. If 12 users donated $1 USD each, totalling $12 USD, the plugin would work for an entire year and remains completely free for all other users who are currently using IMDb Connector.

How can I donate?

Without donations, IMDb Connector will not work. If you would like to continue to use IMDb Connector on your website and support the community, please consider making a donation via PayPal. All donations will be spent on extending the API key of the plugin only. Once the donation goal is complete, the exceeding amount will be refunded.

Donate via PayPal and secure IMDb Connector’s future

FAQ

Installation Instructions

How to install

  1. Install IMDb Connector either through WordPress’ native plugin installer found under Plugins > Install or copy the imdb-connector folder into the /wp-content/plugins/ directory of your WordPress installation.
  2. Make sure the folder /cache/ in the plugin’s directory is writable (CHMOD 755).
  3. Activate the plugin in the plugin section of your admin interface.
  4. Go to Settings > IMDb Connector to customise the plugin as desired.

Obtain an API key

Why do I need one?

IMDb Connector has stopped working since May 2017. This is because the unofficial OMDb API that the plugin uses to fetch movie data from IMDb.com has gone private and now requires an API key. The API keys cost $1 USD, $5 USD or $10 USD per month, depending on how often the API is being used. IMDb Connector can work with the monthly $1 USD API key.

What can I do?

IMDb Connector was meant to be a free plugin and should also be free in the future. However, this only works through donations. If 12 users donated $1 USD each, totalling $12 USD, the plugin would work for an entire year and remains completely free for all other users who are currently using IMDb Connector.

How can I donate?

Without donations, IMDb Connector will not work. If you would like to continue to use IMDb Connector on your website and support the community, please consider making a donation via PayPal. All donations will be spent on extending the API key of the plugin only. Once the donation goal is complete, the exceeding amount will be refunded.

Donate via PayPal and secure IMDb Connector’s future

Reviews

Great plugin and support

Just begun using this plugin and it is the best IMDB plugin available and great support too.

Hope everyone donates to keep this plugin going.

Amazing Functionality and Support

I have been using this plugin for quite a while. The functionality is great and the only thing I struggled with was the poster functionality. After posting on the support forum the plugin developer offered a helping hand and he solved the problem in a few minutes. Thank you for the great support.

Utterly well done

This is a great plugin for many reasons!

First of all I really appreciate the detailed settings page where you can set various caching options and are also presented with a deactivation tab. This shows the amount of thought and detail which went into it and certainly goes much further than just introducing a certain functionality into a plugin.

The documentation is ace, also well done.

Last but not least the plugin is “on point” and does perfectly what it should – connect to IMDb.

Thanks mate!

Read all 17 reviews

Contributors & Developers

“IMDb Connector” is open source software. The following people have contributed to this plugin.

Contributors

Translate “IMDb Connector” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.5.1

  • Temporary hotfix for API usage.
  • Added donation announcement.
  • Compatibility with WordPress 4.8.

1.5.0

  • Added administration option to choose between short and full movie plot.
  • Compatibility with WordPress 4.5.2
  • Updated Font Awesome to 4.6.3.

1.4.2

  • Compatibility with WordPress 4.4.1.

1.4.1

  • Changed table format for “released” movie detail from integer to string, so it no longer returns just the year number but the actual date (YYY-MM-DD). Note: To apply the change, you must drop the whole imdb_connector table in your MySQL database. Thanks to selse for pointing this out.
  • Updated translations.

1.4.0

  • Added shortcode detail “poster_url” to display movie’s poster URL. Please see the “Shortcodes” area in the official documentation for more information.
  • Moved functions to classes IMDb_Connector_Movies and IMDb_Connector_Cache.
  • Updated translations.
  • PHP 7 support.
  • Cleaned up code.
  • Minor cosmetic changes.

1.3.4

  • Removed use of deprecated function in movie widget (thanks to MajorFusion).

1.3.3

  • Extended shortcodes which now accepts several more attributes to let users customise the output even more individually. Please see the “Shortcodes” area in the official documentation for an overview of all available attributes.
  • Added compatibility for WordPress 4.3 that has just been released.
  • Added “Reset Settings” button to the settings page.
  • Fixed bug resulting in an error when activating IMDb Connector.

1.3.2

  • Changed several function names to be deprecated to make it more organised. All functions now start with imdb_connector_*
  • Cleaned up and optimised main.js.
  • Small face lifting on the settings page.
  • Removed debug mode.

1.3.1

  • Fixed bug resulting in corrupt JSON file provided by omdbapi.com, making it unable for the plugin to work (thanks to jcandsv).
  • Added Font Awesome icons to plugin’s settings page.
  • Small code improvements.

1.3.0

  • Added more shortcode parameters and details. From now on you can display the runtime either as “runtime-minutes”, “runtime-hours” or as “runtime-timestamp”.
  • Re-programmed some sections.
  • Updated translations.

1.2.1

  • WordPress 4.2.3 compatibility.
  • Updated translations.

1.2.0

  • Fixed bug.

1.1.0

  • WordPress 4.2.2 compatibility.

1.1

  • Added compatibility with WordPress 4.2.1.
  • Updated translations.

1.0

  • Stable release.
  • Code cleanup and other small optimizations.
  • Updated documentation.
  • Updated translations.
  • Updated screenshots.

0.6.2

  • Fixed bug with newly added movies that do not contain all values.

0.6.1

0.6

  • Fixed bug with PHP version below 5.2.
  • Cleaned up code.

0.5

  • Added plugin installer icon.
  • Code rearrangements.
  • Updated translations.

0.4.3

  • Added “imdbrating” field.
  • Updated translations.

0.4.2

0.4.1

  • Fixed shortcode movie details with multiple values in it.

0.4

  • MySQL cache is now stored in a separate table.
  • Added feature to select the table name the cache data is being stored.
  • Added feature to delete the cache after a certain time automatically.
  • Added feature allowing admins to chose what cached files and settings IMDb Connector should keep after disabling the plugin.
  • Added “type” movie detail that returns the type (documentary, series, movie, …) of the movie.
  • Renamed movie details “genre”, “country”, “language”, “writer” and “director” to plural names.
  • Updated translations.

0.3

  • Added option to chose if the movie detail cache should be stored locally on in MySQL.
  • Added an option to the settings page that defines whether the movie poster should be cached or not.
  • Added “format” option array to imdb_get_connector_movie() function that defines whether the output should be an “array” or “object”.
  • Added translations and updated existing ones.
  • The movie details “genre”, “director”, “writer”, “actors”, “country” and “language” are split up in arrays.
  • The movie detail “runtime” is now an array containing “timestamp”, “minutes” and “hours”.
  • Removed “Use default widgets style” from the settings page.

0.2

  • Added “Delete cache” function on settings page.
  • Added several PHP functions, e.g. search_imdb_connector_movies().
  • Added debug mode to display errors and warnings.
  • Added several translations and updated existing ones.
  • Fixed “headers already sent” bug on plugin activation.
  • Fixed bug that prevented translations from being loaded.
  • Fixed bug when a string run through wptexturize() is used for the IMDb title (thanks to 7movies).
  • Changed get_imdb_* functions to imdb_get_connector_* to avoid conflicts with other plugins.
  • Updated documentation.
  • Rebuild movie widget.
  • Restructured plugin files.

0.1.2

  • Hotfix.

0.1

  • Initial release.