RatePress
RatePress Docs

Getting Started

  • Introduction
  • Getting Started

Core Features

  • Rating System
  • Templates
  • Blocks & Shortcodes

Advanced Features

  • Notifications
  • Confetti Effects

Languages

  • Translation System

Developer Guide

  • Architecture
  • API Reference
GitHubLive Demos

RatePress

The modern rating plugin for WordPress. Built with clean architecture, designed for performance, and loved by developers.

Documentation

  • Get Started
  • Technical Architecture
  • Templates
  • Translations

Resources

  • Download
  • Support
  • Contact
  • Review Us

© 2025 RatePress. All rights reserved.

Made with passion by Code Idealists

TemplatesCommunity Driven

RatePress Templates

Browse, install, and create beautiful rating templates. Choose from community designs or build your own with our live editor and marketplace system.

Browse TemplatesLive EditorContribute on GitHub

Template Ecosystem

RatePress templates provide a complete solution for adding ratings to your WordPress site with beautiful, customizable interfaces.

Template Marketplace

Browse and install community templates with one click

One-click installation
Automatic updates
Version management
Live Template Editor

Preview and customize templates in real-time

Real-time preview
Code editor with syntax highlighting
Export ready-to-use templates
Create & Share

Build custom templates and share with the community

Upload custom templates
Contribute to marketplace
Open-source collaboration

Template Categories

Templates available for all rating types

Binary
Like / Heart

Simple one-button ratings for favorites and likes

Single positive action
Values: 0 (not rated) or 1 (liked)
Use cases: Favorites, likes, bookmarks
Bipolar
Like / Dislike

Two-button ratings for positive and negative feedback

Positive and negative actions
Values: -1 (dislike), 0 (neutral), 1 (like)
Use cases: Voting, feedback, polls
Scale
Star Ratings

Multi-level ratings from 1-5 stars or 1-10 points

Multi-level granularity
Values: 0.0 to 1.0 (normalized)
Use cases: Reviews, quality ratings

Using the Template Marketplace

Install and manage templates directly from your WordPress admin

Browsing Templates

Discover community templates in the marketplace

1

Navigate to Templates

Go to RatePress → Templates in your WordPress admin

2

Filter by Category

Use the category filter to find templates for your rating type

All CategoriesBinaryBipolarScale
3

Search & Preview

Search by name, description, or tags. Click any template to see a live preview

4

View Modes

Switch between different views to find what you need

All TemplatesNew TemplatesInstalledNeeds Update
Templates are cached for 24 hours. Click the Refresh button to force fetch the latest templates

Creating Templates

Build beautiful, functional rating templates from scratch

Rating Widget Structure

All RatePress rating widgets share a common parent structure. Every template must have a root container with specific data attributes that the core JavaScript uses to identify and interact with the widget.

Required Root Attributes
data-object-id
Object ID
The post/comment ID being rated
data-object-type
Object Type
'post' or 'comment'
data-category
Rating Category
'binary', 'bipolar', or 'scale'
data-template
Template Slug
Namespace/name format
Common Structure

Template Files

FilePurposeRequiredLanguage
config.phpTemplate metadata and settingsYesPHP
render.phpHTML/PHP markup with data attributesYesPHP/HTML
style.cssStyling and responsive rulesYesCSS
script.jsOptional animations and effectsNoJavaScript

Rating Types & Data Attributes

RatePress supports three rating categories. Each has different button structures and data-value attributes that determine how ratings are recorded and displayed.

Binary Ratings

Single positive action (like/favorite)

Values
• 0 = Not rated
• 1 = Liked/Favorited
Button Structure
Single button with data-value="1"
Use Cases
Likes, favorites, bookmarks, follows
Example Template

Available PHP Variables

Templates have access to these PHP variables for dynamic content:

Core Variables
$object_idThe post/comment ID
$object_type'post' or 'comment'
$categoryRating category
$user_valueUser's current rating (normalized)
$user_has_ratedBoolean: has user rated?
Statistics Variables
$positive_countCount of positive ratings
$negative_countCount of negative ratings
$averageAverage rating (scale only)
$total_countTotal number of ratings

Best Practices & Features

Responsive Design

Mobile-first approach

Dark Mode Support

Automatic theme adaptation

RTL Support

Right-to-left languages

Accessibility

WCAG 2.1 AA compliance

▶
Testing Your Template

Use the Live Template Editor to test your template in real-time with instant preview
Testing Checklist
Works with the correct rating category (binary/bipolar/scale)
Responsive on mobile, tablet, and desktop screens
Displays correctly in both light and dark modes
Shows correct counts/stats after rating
Active state appears when user has already rated
Keyboard navigation works (Tab, Enter, Space)
No console errors in browser DevTools
Works in Chrome, Firefox, Safari, and Edge

Contributing to the Marketplace

Share your templates with the RatePress community

Contribution Process

Follow these steps to submit your template to the marketplace

1

Fork the Repository

Fork the ratepress-templates repository on GitHub

Open Repository
2

Create Your Template

Add your template to the templates/ directory

3

Test Thoroughly

Ensure your template meets all quality guidelines and works across different scenarios

4

Submit Pull Request

Push to your fork and open a Pull Request with:

  • Clear description of your template
  • Screenshots or GIFs
  • List of key features
  • Testing results
5

Review & Merge

Maintainers will review your template. Once approved, it will be automatically added to the marketplace!

The marketplace manifest (templates.json) is automatically generated via GitHub Actions - you don't need to edit it manually!

Resources & Documentation

Everything you need to create amazing templates

Template Browser

Browse all available templates

View Templates
Live Editor

Build and test templates

Open Editor
GitHub Repository

Contribute your templates

View on GitHub
API Reference

Technical documentation

View API Docs