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
- Upload the plugin files to the
/wp-content/plugins/plugin-name
directory, or install the plugin through the WordPress plugins screen directly.
- Activate the plugin through the 'Plugins' screen in WordPress
- 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
![Actor Shortcode screenshot](https://github.com/f13dev/f13-movie/raw/master/screenshot-3.png)
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