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

Notification System

A headless, cache-friendly toast notification system that provides instant feedback for rating interactions. Fully customizable, scalable, and designed for performance.

Get StartedCustomize

What are Notifications?

RatePress notifications provide instant, non-intrusive feedback to users during rating interactions. From success confirmations to error messages, they enhance user experience without disrupting the flow.

Instant Feedback

Immediate visual confirmation of user actions, improving perceived performance and user satisfaction.

Cache-Friendly

Configuration loaded via WordPress localize script, ensuring compatibility with all caching plugins.

Fully Customizable

Customize messages, appearance, positioning, animations, and behavior to match your site's design.

Translatable

Built-in WordPress i18n support with custom message override capabilities for any language.

How It Works

A headless architecture that separates configuration from presentation, ensuring maximum flexibility and performance.

Headless Design

The notification system is completely decoupled from specific HTML structures, using data attributes and configuration-driven rendering.

Key Components:

  • Configuration Layer: WordPress options → wp_localize_script → JavaScript config
  • Template Engine: Placeholder-based HTML templates with dynamic content
  • Event System: Custom events for extensibility and integration
  • State Management: Lazy initialization with minimal DOM manipulation
This headless approach means you can completely customize the HTML structure, CSS styling, and behavior without touching core files.

Getting Started

Enable and configure notifications in just a few simple steps.

Step 1: Enable Notifications

Navigate to the RatePress admin panel and enable the notification system.

Navigation:

WordPress Admin → RatePress → Notifications
Toggle the "Enable Notifications" switch to activate the system globally.

Step 2: Configure Messages

Choose which notifications to show and customize their text.

Message Types:

  • • Success - Rating submitted
  • • Already Rated - Duplicate attempts
  • • Not Logged In - Authentication required
  • • Rate Limit - Too many requests
  • • Errors - System issues

Step 3: Customize Appearance

Adjust positioning, timing, and visual styling to match your site.

Choose where notifications appear on screen with the visual position selector.

Available Positions:

Top Left
Top Center
Top Right
Bottom Left
Bottom Center
Bottom Right

Message Types

Six built-in notification types with automatic type inference and customizable content.

Success
Disabled
success

Rating submitted successfully

Already Rated
Enabled
error

User has already rated

Not Logged In
Enabled
info

Authentication required

Rate Limit
Enabled
warning

Too many requests

Generic Error
Enabled
error

System error occurred

Invalid Rating
Enabled
error

Invalid rating data

Advanced Customization

Unlock the full potential of the notification system with custom messages, styling, and behavior.

Adding Custom Messages

Extend the notification system with your own custom message types.

Custom messages are stored as plain strings and won't be automatically translated. Use WordPress translation functions when adding them.

Troubleshooting

Common issues and their solutions.

Notifications Not Appearing
  • • Check that notifications are enabled globally
  • • Verify the specific message type is enabled
  • • Ensure JavaScript is loaded and config is available
  • • Check browser console for errors
Styling Issues
  • • Clear browser cache after CSS changes
  • • Use browser dev tools to inspect notification elements
  • • Check for theme CSS conflicts with more specific selectors
  • • Verify CSS is properly escaped in the admin interface
Performance Concerns
  • • Reduce notification duration for better UX
  • • Disable animations if causing issues
  • • Use CSS transforms instead of position changes
  • • Monitor for memory leaks with multiple notifications
Translation Problems
  • • Default messages use WordPress i18n automatically
  • • Custom messages need manual translation
  • • Check .po/.mo files are properly compiled
  • • Use text domain consistently across custom messages

Ready to Enhance User Feedback?

Start providing instant, professional notifications that improve user experience and engagement.

Configure NotificationsBack to Documentation
Need help? Contact Support