Movie Shortcode

Do you blog about movies? It can be tedious adding movie information manually, now you can add movie information with shortcode using an IMDB ID.

About

• Developer: F13Dev
• Tags: movie, tv show, episode, actor, embed, shortcode, imdb, omdb, tmdb
• Requires: WordPress 3.0.1 and up
• Tested to: WordPress 6.2
• License: GPLv3 or later

Description

Using Movie Shortcode you can easily add information about a movie, tv show, episode or actor to a blog post.

Simply enter the shortcode: [movie imdb="an IMDB ID"] or [movie title="A Movie Title"] to a blog post to add an array of information about the movie, tv show or episode; or enter the shortcode [actor tmdb="a TMDB person ID"] or [actor name="An actors name"] to a blog post to add an array of information about the actor.

Movie

Optional attributes (movie):

• cachetime="A time in minutes" - default is 1440 (24 hours)
• plot="short|full" - default is full
• disable="title,image,plot,information,rating" - comma separated list of sections to remove
• image_size="1200" - maximum image size in pixels
• trailer="youtube video ID" - a youtube video ID for the movie trailer

If adding the shortcode with a title, rather than an IMDB ID, the following attributes are also optional to find the correct entry:

• type="movie|series|episode"
• year="The year of the movie"

Actor

Optional attributes (actor):

• cachetime="A time in minutes" - default is 1440 (24 hours)

Features

• Styled appearance
• Shows film title, year, release date
• If showing a series, the total number of seasons is displayed
• If showing an episode, the season and episode number are displayed
• Displays the plot or synopsis
• Displays a poster image if one is available
• If a poster image is available it is added to your media library and loaded locally
• Displays movie stats such as the runtime, genre, awards, director, writer, Actors
• Displays the available languages and country of origin
• Provides the IMDB rating, including a star rating image
• Adds a link to the movie on IMDB
• Utilizes transient caching to reduce page load times and api calls
• Disable widget blocks to customize the appearance to your needs

Installation

1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Add the shortcode [movie imdb="an IMDB ID"], or [movie title="A movie title"] to the desired location on your blog

Frequently Asked Questions

Q) How do I find an IMDB ID

A) When viewing a movie, tv show or episode on IMDB.com, the ID is the string starting with 'tt', usually in the format www.imdb.com/title/imdbid/

Q) How do I adjust the cache time

A) Add the attribute cachetime="a time in minutes" to your shortcode

Q) Using the shortcode with a title returns the wrong movie

A) Try adding the optional attributes, type="movie|series|episode" and year="a year" to refine your search result

Q) How do I hide the plot and information

A) Include the optional "disable" attribute, disable="plot,information"

Screenshots

Changelog

2.1.4

• Fix removing all non alphanumeric characters from IMDB ID

2.1.3

• Fix instructions for TMDB API, Read Access Token is required, not API Key

2.1.2

• Improved error handling for TMDB API, if API returns an error, this is presented to the user
• Notify user of success / error when saving admin settings
• Fix: setting cachetime=0 in shortcode forces API call on every page load

2.1.1

• Adding alt text to images
• Setting TMDB logo as no-lightbox
• Removing console logs if F13_MOVIE_DEV is false

2.1.0

• Adding "image_size" attribute to movie shortcode
• Adding "trailer" attribute to movie shortcode
• Adding secondary API via "The Movie Database"
• Adding "actor" shortcode

2.0.4

• Adding "title" to disable fields

2.0.3

• CSS box sizing, stopping plot overflowing into other elements

2.0.2

• Optional attribute to disable blocks from the widget

1.0

• Initial release