Movie Review & Rating Plugin — Documentation
Version: 1.0.0 Requires: WordPress 5.8+, PHP 7.4+ Text Domain: movie-review-rating-by-tenvow
Movie Review & Rating by Tenvow adds a simple movie review box to your posts and outputs valid Movie + Review + Rating structured data (JSON-LD) automatically — using information WordPress already has, so you never enter the same thing twice.
This page covers everything the plugin does, field by field.
1. What this plugin does
- Adds a “Movie Review & Rating” box to the post editor with six fields: Enable, Movie Name, Rating, Director, Cast, Release Date.
- Displays a clean, responsive, gold-themed review card at the top of the post content on the front end.
- Outputs
Movie,Review, andRatingJSON-LD schema in<head>, built from the fields you fill in plus data WordPress already stores (featured image, excerpt, author, dates, permalink, site name/logo). - Adds a small Settings page (About / Support Development / Advanced).
- Adds an optional Dashboard widget for administrators.
What it deliberately does not do: no ads, no tracking or telemetry, no email collection, no license activation, no upsells, no premium version, no third-party CSS/JS libraries.
2. Installation
- Upload the plugin folder to
/wp-content/plugins/, or install it directly from the Plugins screen in WordPress. - Activate Movie Review & Rating by Tenvow from the Plugins screen.
- Open any post in the editor. You’ll see a “🎬 Movie Review & Rating” box in the sidebar.
- Check Enable Movie Review, fill in the fields, and publish or update the post.
- Visit the post on the front end — the review card appears above your content automatically.
No configuration is required to get started. The Settings page (see Section 5) is optional.
3. The meta box fields
| Field | Required for schema? | Notes |
|---|---|---|
| Enable Movie Review | Yes | Master switch. If unchecked, neither the review card nor the schema is shown, even if other fields are filled in. |
| Movie Name | Yes | Free text. Used as the Movie.name in schema and as the card’s title. |
| Rating | Yes | A number from 0–10, in steps of 0.1 (e.g. 7.5). Used for Review.reviewRating.ratingValue and the card’s big score. |
| Director | Yes | Free text, single name. Used for Movie.director. |
| Cast | Yes | Comma-separated list, e.g. Actor One, Actor Two, Actor Three. Each name becomes a separate Movie.actor entry. |
| Release Date | Yes | A date picker. Used for Movie.dateCreated and shown on the card as a plain date (see Section 8). |
All six conditions (Enable + the five fields above) must be met for the plugin to output schema for that post. If even one is missing, no schema is printed at all — the plugin never emits partially-filled or guessed structured data.
What you don’t need to enter
The plugin automatically pulls the following from WordPress itself — there are no separate fields for these:
- Poster image → the post’s Featured Image
- Review body → the post’s excerpt (or the first ~40 words of the content if no excerpt is set)
- Author → the post’s author display name
- Publish / modified dates → the post’s own dates
- URL → the post’s permalink
- Publisher name → your site’s name (Settings → General)
- Publisher logo → your Custom Logo (Appearance → Customize → Site Identity), falling back to your Site Icon if no custom logo is set
4. The front-end review card
When a post has the review box enabled with a rating, the card is automatically inserted at the top of the post content. It shows:
- The featured image as a small poster thumbnail (if one is set)
- The movie name
- A large rating score out of 10, with a star icon
- A verdict pill (Poor / Below Average / Average / Good / Very Good / Excellent / Masterpiece, based on the rating)
- Director, Cast, and Release Date, if filled in
The card’s stylesheet only loads on posts that actually have a review enabled — it never adds weight to any other page on your site. There is no JavaScript involved; the card is pure HTML/CSS.
Styling: the card uses a gold color theme and is fully responsive down to small mobile widths. If you want to customize its appearance, you can target the .tenvow-mrr-card class and its children in your theme’s CSS.
5. Settings page
Go to Settings → Movie Review & Rating in your WordPress admin. It has three tabs:
About
Shows the plugin name, installed version, and a link to this documentation.
Support Development
An optional way to support the plugin’s development:
- Buy Me a Coffee — opens a PayPal.me link.
- Pay via UPI — on a mobile device with a UPI app installed (Google Pay, PhonePe, Paytm, etc.), this opens that app with the payment details pre-filled. On desktop, this link can’t do anything (there’s no UPI app registered in a browser) — the UPI ID is also shown as plain text so you can copy it or use it with a QR code instead.
Supporting the plugin is entirely optional and has no effect on functionality.
Advanced
One setting: Delete plugin data on uninstall, off by default.
- Off (default): if you delete the plugin, all review data stays in your database. Reinstalling the plugin brings it right back.
- On: deleting the plugin also permanently removes every review field (Enable, Movie Name, Rating, Director, Cast, Release Date) it has ever stored, across all posts.
This only takes effect when the plugin is deleted from the Plugins screen — deactivating it does nothing to your data either way.
6. Dashboard widget
Administrators (anyone who can manage options) will see a small “🎬 Movie Review & Rating” widget on the WordPress Dashboard. It shows:
- How many published posts currently have a review enabled.
- The same Support Development links described above.
- A link back to the Settings page.
To hide this widget: open the “Screen Options” panel at the top of the Dashboard screen and uncheck it. Like any WordPress dashboard widget, this choice is remembered per user account.
7. Structured data (schema) details
The plugin outputs a single <script type="application/ld+json"> block in wp_head on singular posts that have a fully-filled-in, enabled review. It only ever contains three schema types:
Movie— name, image (featured image), url (permalink), dateCreated (your Release Date field), director, actor(s).Review— nested inside the Movie, with author (post author), publisher (your site name + logo), reviewBody (excerpt), datePublished, dateModified, and reviewRating.Rating— nested inside the Review, with ratingValue (your Rating field), bestRating (10), worstRating (0).
What it intentionally never outputs
AggregateRating, Budget, BoxOffice, Awards, Runtime, Genre, ProductionCompany, and Trailer are never generated, because the plugin doesn’t collect that data. Outputting schema fields with guessed or empty values is a common cause of invalid structured data — this plugin avoids that entirely by only ever emitting the fields it can populate with real information.
You can verify the output at any time using Google’s Rich Results Test or validator.schema.org.
Compatibility with Rank Math and other SEO plugins
This plugin’s schema output is completely independent. It does not read, modify, remove, or duplicate any schema generated by Rank Math or any other SEO plugin — it works identically whether or not Rank Math is active.
8. Why the Release Date shows no time
The Release Date field only ever stores a plain calendar date — there’s no time component in the database at all. The front-end card formats it using a fixed date-only format, independent of your site’s general “Date Format” setting under Settings → General (which some themes configure to include a time, for post-publish timestamps). This guarantees the Release Date never shows a meaningless “12:00 am” next to it.
If you’d like to customize the display format, a developer can use the tenvow_mrr_release_date_format filter:
add_filter( 'tenvow_mrr_release_date_format', function( $format ) {
return 'j F Y'; // e.g. "15 January 2026"
} );
9. Frequently asked questions
Does this work on pages or custom post types? The review box currently appears on standard posts only.
Will my existing reviews still work after updating? Yes. The plugin has kept the same underlying data fields across every version — updating never breaks or resets existing review data.
Does the plugin add tracking, ads, or collect emails? No, none of these are present anywhere in the plugin.
What happens to my data if I delete the plugin? Nothing, by default. See Section 5, Advanced for the opt-in deletion setting.
Why isn’t the review card or schema showing on my post? Check that Enable Movie Review is checked and that Movie Name, Rating, Director, Cast, and Release Date are all filled in. If even one is empty, both the card’s schema and (for schema specifically) the whole JSON-LD block are withheld.
10. Support
Found a bug or have a question not covered here? Reach out via the plugin’s support page, or consider supporting continued development from the Settings page’s Support Development tab.
Thanks for using Movie Review & Rating by Tenvow! It stays free, ad-free, and free of tracking — if it saves you time, a small tip helps keep it that way.







