My Movie Database

Descripción

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.

New version 2 of the plugin is here!

Version 2 brings many changes, new features and improvements. A big part of the plugin was rewritten from scratch.

Improvements

1. Javascript asynchronous template rendering (using VueJS)
2. Improved page load speed and overall user experience (your pages won’t wait for the movie data to load)
3. Overview (description) on hover (configurable option) for person credits and tvshow seasons
4. Transition effect configurable option when switching between sections / tabs
5. Enhanced admin search UI and preview resembling the frontend output based on selected settings
6. Rearrangement of person credit sections with improved section consistency (crew / cast credits)
7. Fixed a few bugs

Breaking changes

While the overall styling of the two main templates (tabs and accordion) and all previous settings have been preserved, there are some breaking changes:

• Removed: PHP based templates

  This means that previous templates are no longer compatible. This will be a problem if you have made modifications to your templates.

  If you have copied your templates folder inside your theme, you must delete the copied folder for the plugin to work.

• Removed: Support for Internet Explorer prior to version 11

  Please note that as of version 2.0 of the plugin, support for the Internet Explorer browser is limited to version 11 only.

• Removed: Section 4 for persons

  The person template has been rearranged, most users should not have a problem with this as it was previously not very nice.

  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.

2. You will then be presented with the search results. Hover over them for further info and click on the desired movie.

   (screenshot 4)

3. Once you have made 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 predetermined 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
6. the CSS transition to use when switching sections

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:

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 4)

• 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 refer 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 predetermined 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.