Plugin / My Movie Database

Description

The My Movie Database plugin compliments your content by adding information about the movies, the television shows and the people in the industry you choose.

The plugin was developed to enrich your movie or tvshow content / review by ‘automatically’ adding the related information and allowing you to focus on your writing instead.

You can use it via shortcodes or the standard posts method, see below for more info and/or the live demo page.

The data comes from the Movie Database (TMDb), the leading crowdsourced movie industry information community. This means that this plugin will make calls to the TMDb api (in other words their ‘website service’) to retrieve the requested data. The TMDb API service is provided free of charge.
– The My-Movie-Database plugin uses the TMDb API but is in no way endorsed or certified by TMDb.

How to use the plugin

The My-Movie-Database (mmdb) plugin can be used via shortcodes or inside wordpress posts (and post types).

After installing the plugin three custom post types are created in wordpress: Movies, TvShows and Persons.

You can disable any one of them (or all of them if you want to use this plugin only via shortcode) by going into the Advanced options tab of the Movie Database options and selecting “No” for the post types you don’t want.

The shortcode method will always be available for all resource types (Movies, TvShows, etc) regardless of the state of the mmdb options for each post type.

Below is an outline of the two methods: WordPress posts and shortcodes

Using the plugin with WordPress posts

So as was mentioned above, by default the plugin will create three custom post types in wordpress: Movies, TvShows and Persons.

These custom post types behave just like your regular wordpress post type except that they have an mmdb section to configure.

Adding a New Movie (or editing a Movie post):

Below the content textarea of your Movie post you will find the mmdb search for a movie field.

1. Enter the title of the movie you are looking for and click on search.

2. You will then be presented with the search results. Click on the desired movie.

(screenshot 4)

1. A pop up will appear asking you to confirm your selection or to return to the previous page.

(screenshot 5)

1. Once you have confirmed your selection you must save the post.

That’s it! Now if you navigate to the url of your post (front-end), the movie information will be displayed.

Configuration and customization of display

From the plugin option page you can configure:

1. which template will be used to display your resource
2. if this should appear before or after the post content
3. select from a predermined set of width combinations for multiple column arrangements as seen on sections like cast and crew.
4. which sections to display/hide
5. the header and body colors for the available templates

For the Movie posts only (in the advanced configuration option tab) :

1. You have the option of using the default wordpress posts instead of a new custom post type.
2. You also have the option of renaming the default WP posts into movies or leaving them as is (‘Posts’).

See the configuration documentation page for more detailed info.

All the of the above apply for TvShows and Persons as well.

Using the plugin with shortcodes

The plugin shortcode is [my_movie_db] . The parameters that can be set are id, type, template and size.

1. The basic parameters that you need to set are id and type.
2. Optional parameters to override the global plugin settings are : template, size, body (color) and header (color).

1-) id
The most important parameter is the id of the movie, tvshow or person info you wish to display. This parameter corresponds to the unique id of the resource at the TMDb website.

You can find the id by searching for the movie, tvshow or person:

• In the respective custom post type edit screen in your wordpress backend See ‘Adding a New Movie (or editing a Movie post)’ above (visible on screenshot 5)

• At the TMDb website:

Once you find the desired id you use it like this:

[my_mοvie_db id=yοur_id]

If you don’t specify an id the id of 655 will be used.

2-) type
The type parameter corresponds to the type of resource you are looking for. Possible acceptable values are movie, tvshow or person

So for example if you are looking to display a tvshow your shortcode should look like this:

[my-mοvie-db id=yοur_id type=tvshow]

The default type value is “movie” so if you don’t specify the type, the movie type will be used.

3-) template (optional – override)

The template parameter defines the mmdb template you wish to use to display your resource.

• Current templates available that ship with the plugin are **tabs** and **accordion.**

So if for example you want to use the accordion template file your shortcode will look like this:

[my-mοvie-db id=your_id type=yοur_type template=accordion]

The default template value is “tabs” so if you don’t specify the template, the tabs template will be used.

If you want to make/use your own template, and/or edit the existing templates reter to the configuration documentation under ‘Choosing the template to use’.

4-) size (optional – override)

Depending on the width setup/style of your target page, you can select from a predermined set of width combinations for a best fit. This setting only affects bootstrap multiple column arrangements (for now) as seen on sections like cast and crew.

So if you have a full-width area with a no sidebar layout you would choose ‘large‘, ‘medium‘ if you have one sidebar and ‘small‘ for a two sidebar area. The default value is ‘medium’.

[my-mοvie-db id=your_id type=yοur_type size=large]

See the width setting demo example on the plugin site page.

5-) header and body (optional – override)

The background color for the ‘body’ and ‘header’ area of the templates.

These two settings combine to give 2 color schemes to your tabs and accordion templates.

In the case of tabs, the selected and the hovered tabs will get the ‘header’ color as well.

Using a valid css color for these settings, your shortcode will look like this:

[my-mοvie-db id=your_id type=yοur_type size=large header=#265a88 body=#122a40]

Shortcode examples

See the demo shortcode examples on the plugin site page for more info.

Configuration and customization of display

From the plugin options page you can select which sections to display/hide, default templates, predefined widths, body and header colors, etc.

See the configuration documentation page for more detailed info.