Best Practices for Inserting IMDb Info in Movie Databases

WordPress Tutorial: Insert IMDb Info into Posts and Pages

Overview

This tutorial shows how to add IMDb information (title, year, rating, poster, plot, cast) into WordPress posts/pages using a safe, maintainable approach: fetch IMDb data via a third-party API, store results in post meta, and display via shortcodes or theme templates.

Steps

1. Choose an IMDb data source

   • OMDb API (free tier, API key required) — returns JSON for titles.
   • TMDb API (The Movie Database) — alternative with richer images; requires attribution.
   • RapidAPI IMDb wrappers — commercial options if you need IMDb-only endpoints.

2. Get API credentials

   • Sign up at the provider (OMDb: http://www.omdbapi.com/; TMDb: https://www.themoviedb.org/).
   • Copy your API key.

3. Add a custom meta box to posts/pages (store IMDb ID or title)

   • Register meta box in your theme’s functions.php or a small plugin.
   • Save a field named, for example, _imdb_id (e.g., tt0111161) or _movietitle.

   Example (conceptual):

   Code
    ffON2NH02oMAcqyoh2UU MQCbz04ET5EljRmK3YpQ CPXAhl7VTkj2dHDyAYAf” data-copycode=“true” role=“button” aria-label=“Copy Code”>Copy CodeCopied
   // add_meta_box(‘imdb_box’, ‘IMDb Info’, ‘render_imdb_box’, ‘post’); // save_post -> update_post_meta(\(post_id, '_imdb_id', \)_POST[‘imdb_id’]); 

4. Fetch IMDb data from the API and cache it as post meta

   • On save (or on demand), call the API with the IMDb ID or title.
   • Store returned JSON (or selected fields) in post meta like _imdb_data and set a timestamp _imdb_fetched_at.
   • Implement cache expiry (e.g., refresh every 7–30 days).

   Example flow:

   • Build request: https://www.omdbapi.com/?i=tt0111161&apikey=YOUR_KEY
   • wp_remote_get(), wp_remote_retrieve_body(), json_decode()
   • update_post_meta(\(post_id, ‘_imdb_data’, \)data_array);

5. Create a shortcode to display IMDb info in content

   • Register a shortcode [imdb_info fields=“title,year,rating”].
   • Shortcode handler reads post meta _imdb_data, formats HTML, and returns it.
   • Allow attributes to choose which fields to show.

   Example output structure:

   • Poster image (linked), Title (year), IMDb rating, Runtime, Genre, Short plot, Top 3 cast.

6. Display in theme templates

   • Use get_post_meta(\(post->ID, ‘_imdb_data’, true) inside single.php or template parts.</li> <li>Use esc_html(), esc_url(), and wp_kses_post() when outputting to ensure safety.</li> </ul> </li> <li> <p>Styling and accessibility</p> <ul> <li>Provide responsive poster images (srcset) and alt text.</li> <li>Use semantic markup (figure/figcaption) and ARIA where appropriate.</li> <li>Add CSS classes so site styles can control layout.</li> </ul> </li> <li> <p>Error handling and fallbacks</p> <ul> <li>Show a friendly message if API fails or data missing.</li> <li>Offer manual override fields (title, poster URL, synopsis) stored in post meta.</li> </ul> </li> <li> <p>Example plugins (optional)</p> <ul> <li>Consider existing plugins that integrate movie APIs; evaluate security, updates, and licensing before use.</li> </ul> </li> </ol> <h3>Security and rate limits</h3> <ul> <li>Protect your API key: store in wp-config.php or options table, not directly in public code.</li> <li>Respect API rate limits; implement caching and conditional fetching.</li> <li>Sanitize all external data before saving or outputting.</li> </ul> <h3>Minimal example: shortcode handler (conceptual)</h3> <pre><div class="XG2rBS5V967VhGTCEN1k"><div class="nHykNMmtaaTJMjgzStID"><div class="HsT0RHFbNELC00WicOi8"><i><svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" fill-rule="evenodd" clip-rule="evenodd" d="M15.434 7.51c.137.137.212.311.212.49a.694.694 0 0 1-.212.5l-3.54 3.5a.893.893 0 0 1-.277.18 1.024 1.024 0 0 1-.684.038.945.945 0 0 1-.302-.148.787.787 0 0 1-.213-.234.652.652 0 0 1-.045-.58.74.74 0 0 1 .175-.256l3.045-3-3.045-3a.69.69 0 0 1-.22-.55.723.723 0 0 1 .303-.52 1 1 0 0 1 .648-.186.962.962 0 0 1 .614.256l3.541 3.51Zm-12.281 0A.695.695 0 0 0 2.94 8a.694.694 0 0 0 .213.5l3.54 3.5a.893.893 0 0 0 .277.18 1.024 1.024 0 0 0 .684.038.945.945 0 0 0 .302-.148.788.788 0 0 0 .213-.234.651.651 0 0 0 .045-.58.74.74 0 0 0-.175-.256L4.994 8l3.045-3a.69.69 0 0 0 .22-.55.723.723 0 0 0-.303-.52 1 1 0 0 0-.648-.186.962.962 0 0 0-.615.256l-3.54 3.51Z"></path></svg></i><p class="li3asHIMe05JPmtJCytG wZ4JdaHxSAhGy1HoNVja cPy9QU4brI7VQXFNPEvF">Code</p></div><div class="CF2lgtGWtYUYmTULoX44"><button type="button" class="st68fcLUUT0dNcuLLB2_ ffON2NH02oMAcqyoh2UU MQCbz04ET5EljRmK3YpQ CPXAhl7VTkj2dHDyAYAf" data-copycode="true" role="button" aria-label="Copy Code"><svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" fill-rule="evenodd" clip-rule="evenodd" d="M9.975 1h.09a3.2 3.2 0 0 1 3.202 3.201v1.924a.754.754 0 0 1-.017.16l1.23 1.353A2 2 0 0 1 15 8.983V14a2 2 0 0 1-2 2H8a2 2 0 0 1-1.733-1H4.183a3.201 3.201 0 0 1-3.2-3.201V4.201a3.2 3.2 0 0 1 3.04-3.197A1.25 1.25 0 0 1 5.25 0h3.5c.604 0 1.109.43 1.225 1ZM4.249 2.5h-.066a1.7 1.7 0 0 0-1.7 1.701v7.598c0 .94.761 1.701 1.7 1.701H6V7a2 2 0 0 1 2-2h3.197c.195 0 .387.028.57.083v-.882A1.7 1.7 0 0 0 10.066 2.5H9.75c-.228.304-.591.5-1 .5h-3.5c-.41 0-.772-.196-1-.5ZM5 1.75v-.5A.25.25 0 0 1 5.25 1h3.5a.25.25 0 0 1 .25.25v.5a.25.25 0 0 1-.25.25h-3.5A.25.25 0 0 1 5 1.75ZM7.5 7a.5.5 0 0 1 .5-.5h3V9a1 1 0 0 0 1 1h1.5v4a.5.5 0 0 1-.5.5H8a.5.5 0 0 1-.5-.5V7Zm6 2v-.017a.5.5 0 0 0-.13-.336L12 7.14V9h1.5Z"></path></svg>Copy Code</button><button type="button" class="st68fcLUUT0dNcuLLB2_ WtfzoAXPoZC2mMqcexgL ffON2NH02oMAcqyoh2UU MQCbz04ET5EljRmK3YpQ GnLX_jUB3Jn3idluie7R"><svg fill="none" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" fill-rule="evenodd" d="M20.618 4.214a1 1 0 0 1 .168 1.404l-11 14a1 1 0 0 1-1.554.022l-5-6a1 1 0 0 1 1.536-1.28l4.21 5.05L19.213 4.382a1 1 0 0 1 1.404-.168Z" clip-rule="evenodd"></path></svg>Copied</button></div></div><div class="mtDfw7oSa1WexjXyzs9y" style="color: var(–sds-color-text-01); font-family: var(–sds-font-family-monospace); direction: ltr; text-align: left; white-space: pre; word-spacing: normal; word-break: normal; font-size: var(–sds-font-size-label); line-height: 1.2em; tab-size: 4; hyphens: none; padding: var(–sds-space-x02, 8px) var(–sds-space-x04, 16px) var(–sds-space-x04, 16px); margin: 0px; overflow: auto; border: none; background: transparent;"><code class="language-text" style="color: rgb(57, 58, 52); font-family: Consolas, "Bitstream Vera Sans Mono", "Courier New", Courier, monospace; direction: ltr; text-align: left; white-space: pre; word-spacing: normal; word-break: normal; font-size: 0.9em; line-height: 1.2em; tab-size: 4; hyphens: none;"><span>function imdb_info_shortcode(\)atts){ \(post_id = \)atts[‘id’] ?? get_the_ID(); \(data = get_post_meta(\)post_id, ‘_imdb_data’, true); if (!\(data) return ‘<p>No IMDb info available.</p>’; return ‘<div class="imdb-card"><img src="’.esc_url(\)data[‘Poster’]).‘” alt=“’.esc_attr(\(data[‘Title’]).’ poster"><h3>’.esc_html(\)data[‘Title’]).’ (‘.esc_html(\(data[‘Year’]).’)</h3><p>IMDb: ‘.esc_html(\)data[‘imdbRating’]).’