iWorks Rate module

It will display a welcome message upon plugin activation that offers the user a 5-day introduction email course for the plugin. After 7 days the module will display another message asking the user to rate the plugin on wordpress.org

How to use it

1. Insert this repository as sub-module into the existing project

2. Include the file module.php in your main plugin file.

3. Call the action wdev-register-plugin with the params mentioned below.

4. Done!

Code Example (from Sierotki)

#!php

<?php
// Load the iWorks-Rate module.
include_once 'vendor/iworks/rate/rate.php';

// Register the current plugin.
do_action(
	'iworks-register-plugin',
    /* plugin ID    */ plugin_basename( __FILE__ ),
    /* Plugin Title */ __( 'iWorks PWA', 'iworks-pwa' ),
    /* Plugin slug  */ 'iworks-pwa'
);
// All done!

1. Always same, do not change
2. The plugin title.
3. The plugin slug.

Changelog

2.3.2 (2025-10-14)

• Bugfix: Anniversary value was not updated correctly. Props for Paweł Patyk.

2.3.1 (2025-05-29)

• Added: Missing textdomain has been added.

2.3.0 (2025-05-20)

• Added: Anniversary notification system to celebrate plugin usage milestones. #1
• Added: New template system for anniversary messages with first-year and subsequent year variations.
• Added: show_anniversary() method to handle anniversary-specific notifications.
• Added: hide_anniversary() method to manage anniversary notice dismissal.
• Added: Support for tracking and displaying plugin usage anniversaries.
• Added: Custom UTM parameters for anniversary-related donation links.
• Updated: Modified render_message() to support custom template groups.
• Updated: Enhanced admin.js to handle anniversary-specific actions.
• Updated: Added new template files for anniversary messages.
• Fixed: Improved donation link handling with proper UTM parameters.

2.2.3 (2025-02-12)

• The wp_rand() and fallback mt_rand() functions have been added.

2.2.2 (2025-02-11)

• The sanitize_text_field has been added.

2.2.1 (2024-12-02)

• Checking for registered plugin has been added.

2.2.0 (2024-08-20)

• Escaping were been added to templates.
• WP function wp_rand has been copied to avoid to early calling.

2.1.9 (2024-03-13)

• The rand() function has been removed.
• Escaping were been added to templates.

2.1.8 (2024-02-16)

• Min/max values have been fixed.

2.1.7 (2024-01-16)

• Typo in text domain has been fixed.

2.1.6 (2023-12-18)

• Usage of the wp_rand() function has been improved.

2.1.5 (2023-12-03)

• The iworks_rate_plugin_data filter has been added.
• Checking nonce for dashbord actions has been added.

2.1.4 (2023-11-30)

• Data input sanitization has been added.
• The defnition of class propery hass been added to avoid deprecated message about creation of dynamic property in PHP 8.2.
• The function rand() has been replaced by the function wp_rand().
• The date() function has been replced by the `gmdate()' function.

2.1.3 (2023-10-13)

• Data input sanitization has been added.

2.1.2 (2023-03-18)

• A problem with escaping empty strings has been resolved.

2.1.1 (2022-09-01)

• Replced FILTER_SANITIZE_STRING by FILTER_DEFAULT to avoid PHP 8x warnings.
• Significant increase in sleep time for showing banners.
• Reduced size of iworks-logo.svg file.

2.1.0 (2022-02-17)

• Added ability to show "OG — Better Share on Social Media" plugin install proposal.

2.0.6 (2022-01-18)

• Added ability to change slug and title during iworks-register-plugin.

2.0.5 (2021-12-20)

• Fixed settigns page url (depend on plugin slug).

2.0.4 (2021-08-11)

• Fixed review url.

2.0.3 (2021-06-29)

• Fixed urls.

2.0.2 (2021-06-24)

• Added "Provide us a coffee" and "Settings" by default.