WDEV Frash module

WPMU DEV Free Dashboard module (short wdev-frash) is used in our free plugins hosted on wordpress.org 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 Smush )

#!php

<?php
// Load the WDev-Frash module.
include_once 'lib/wdev-frash/module.php';

// Register the current plugin.
do_action(
    'wdev-register-plugin',
    /* 1             Plugin ID */ plugin_basename( __FILE__ ),
    /* 2          Plugin Title */ 'Smush',            
    /* 3 https://wordpress.org */ '/plugins/wp-smushit/',
    /* 4      Email Button CTA */ __( 'Get Fast!', MYD_TEXT_DOMAIN ),  
    /* 5  Mailchimp List id for the plugin - e.g. 4b14b58816 is list id for Smush */ '4b14b58816'
);
// All done!

1. Always same, do not change
2. The plugin title, same as in the plugin header (no translation!)
3. The wordpress.org plugin-URL
4. Optional: Title of the Email-subscription button. If empty no email message is displayed.
5. Optional: Mailchimp List id for the plugin. If empty no email message is displayed

Optional: Customize the messages via filters

<?php
// The email message contains 1 variable: plugin-name
add_filter(
    'wdev-email-message-' . plugin_basename( __FILE__ ),
    'custom_email_message'
);
function custom_email_message( $message ) {
    $message = 'You installed %s! This is a custom <u>email message</u>';
    return $message;
}

<?php
// The rating message contains 2 variables: user-name, plugin-name
add_filter(
    'wdev-rating-message-' . plugin_basename( __FILE__ ),
    'custom_rating_message'
);
function custom_rating_message( $message ) {
    $message = 'Hi %s, you used %s for a while now! This is a custom <u>rating message</u>';
    return $message;
}