options field name. * * @since 1.0.0 * @var string */ protected $option_name = 'iworks_rates'; /** * List of all registered plugins. * * @since 1.0.0 * @var array */ protected $plugins = array(); /** * Module options that are stored in database. * Timestamps are stored here. * * Note that this option is stored in site-meta for multisite installs. * * @since 1.0.0 * @var array */ protected $stored = array(); /** * Initializes and returns the singleton instance. * * @since 1.0.0 */ static public function instance() { static $Inst = null; if ( null === $Inst ) { $Inst = new iworks_rate(); } return $Inst; } /** * Set up the iworks_rate module. Private singleton constructor. * * @since 1.0.0 */ private function __construct() { /** * settings */ $this->stored = wp_parse_args( get_site_option( $this->option_name, false, false ), array() ); /** * actions */ add_action( 'load-index.php', array( $this, 'load' ) ); add_action( 'iworks-register-plugin', array( $this, 'register' ), 5, 3 ); add_action( 'wp_ajax_iworks_rate_button', array( $this, 'ajax_button' ) ); add_action( 'admin_init', array( $this, 'admin_init' ) ); /** * own hooks */ add_filter( 'iworks_rate_assistance', array( $this, 'filter_get_assistance_widget' ), 10, 2 ); add_filter( 'iworks_rate_love', array( $this, 'filter_get_love_widget' ), 10, 2 ); /** * advertising * * @since 2.1.0 */ add_filter( 'iworks_rate_advertising_og', array( $this, 'filter_get_advertising_og' ) ); } /** * Inicialize admin area * * @since 2.0.2 */ public function admin_init() { foreach ( $this->plugins as $plugin_file => $plugin ) { add_filter( 'plugin_action_links_' . $plugin_file, array( $this, 'add_donate_link' ), 10, 4 ); } } /** * Add donate link to plugin_row_meta. * * @since 2.0.2 * * @param array $actions An array of the plugin's metadata, including the version, author, author URI, and plugin URI. */ public function add_donate_link( $actions, $plugin_file, $plugin_data, $context ) { $slug = 'iworks'; if ( isset( $this->plugins[ $plugin_file ] ) && isset( $this->plugins[ $plugin_file ]['slug'] ) ) { $slug = $this->plugins[ $plugin_file ]['slug']; } $settings_page_url = apply_filters( 'iworks_rate_settings_page_url_' . $slug, null ); if ( ! empty( $settings_page_url ) ) { $actions['settings'] = sprintf( '%s', esc_url( $settings_page_url ), __( 'Settings', 'omnibus' ) ); } $actions['donate'] = sprintf( '%s', $slug, __( 'Provide us a coffee', 'omnibus' ) ); return $actions; } public function load() { $plugin_id = $this->choose_plugin(); if ( empty( $plugin_id ) ) { return; } $this->plugin_id = $plugin_id; add_action( 'admin_enqueue_scripts', array( $this, 'enqueue' ) ); add_action( 'admin_notices', array( $this, 'show' ) ); } /** * Save persistent module-data to the WP database. * * @since 1.0.0 */ protected function store_data() { update_site_option( $this->option_name, $this->stored ); } /** * Action handler for 'iworks-register-plugin' * Register an active plugin. * * @since 1.0.0 * @param string $plugin_id WordPress plugin-ID (see: plugin_basename). * @param string $title Plugin name for display. * @param string $slug the plugin slug on wp.org */ public function register( $plugin_id, $title, $slug ) { // Ignore incorrectly registered plugins to avoid errors later. if ( empty( $plugin_id ) || empty( $title ) || empty( $slug ) ) { return; } $data = array( 'title' => $title, 'slug' => $slug, ); $this->plugins[ $plugin_id ] = $data; /** * check for option update * * @since 2.0.6 * */ $update = false; /* * When the plugin is registered the first time we store some infos * in the persistent module-data that help us later to find out * if/which message should be displayed. */ if ( empty( $this->stored[ $plugin_id ] ) ) { $this->stored[ $plugin_id ] = wp_parse_args( array( 'registered' => time(), 'show_at' => time() + rand( 7, 14 ) * DAY_IN_SECONDS, 'rated' => 0, 'hide' => 0, ), $data ); $update = true; } /** * check slug & mark for update if needed * * @since 2.0.6 */ if ( $this->stored[ $plugin_id ]['slug'] !== $slug ) { $this->stored[ $plugin_id ]['slug'] = $slug; $update = true; } /** * check title - can be diferent due language * * @since 2.0.6 */ $this->stored[ $plugin_id ]['title'] = $title; /** * Finally save the details if it is needed */ if ( $update ) { $this->store_data(); } } /** * Ajax handler called when the user chooses the CTA button. * * @since 1.0.0 */ public function ajax_button() { $plugin_id = filter_input( INPUT_POST, 'plugin_id', FILTER_DEFAULT ); if ( empty( $plugin_id ) ) { wp_send_json_error(); } if ( ! isset( $this->plugins[ $plugin_id ] ) ) { wp_send_json_error(); } switch ( filter_input( INPUT_POST, 'button', FILTER_DEFAULT ) ) { case '': case 'add-review': $this->add_weeks( $plugin_id ); wp_send_json_success(); case 'hide': $this->add_weeks( $plugin_id ); $this->hide( $plugin_id ); wp_send_json_success(); case 'donate': $this->add_months( $plugin_id ); wp_send_json_success(); } wp_send_json_success(); } public function hide( $plugin_id ) { if ( ! isset( $this->stored[ $plugin_id ] ) ) { return; } $this->stored[ $plugin_id ]['rated'] = time(); $this->store_data(); } private function add_weeks( $plugin_id ) { if ( ! isset( $this->stored[ $plugin_id ] ) ) { return; } $this->stored[ $plugin_id ]['show_at'] = time() + rand( 4, 6 ) * WEEK_IN_SECONDS + rand( 0, 7 ) * DAY_IN_SECONDS; $this->store_data(); } private function add_months( $plugin_id ) { if ( ! isset( $this->stored[ $plugin_id ] ) ) { return; } $this->stored[ $plugin_id ]['show_at'] = time() + rand( 15, 30 ) * WEEK_IN_SECONDS + rand( 0, 14 ) * DAY_IN_SECONDS; $this->store_data(); } /** * Ajax handler called when the user chooses the dismiss button. * * @since 1.0.0 */ public function dismiss() { $plugin = $this->get_plugin_from_post(); if ( is_wp_error( $plugin ) ) { wp_send_json_error(); } wp_send_json_success(); } /** * Action handler for 'load-index.php' * Set-up the Dashboard notification. * * @since 1.0.0 */ public function enqueue() { wp_enqueue_style( __CLASS__, plugin_dir_url( __FILE__ ) . 'admin.css', array(), $this->version ); wp_enqueue_script( __CLASS__, plugin_dir_url( __FILE__ ) . 'admin.js', array(), $this->version, true ); } /** * Action handler for 'admin_notices' * Display the Dashboard notification. * * @since 1.0.0 */ public function show() { $this->render_message( $this->plugin_id ); } /** * Check to see if there is a pending message to display and returns * the message details if there is. * * Note that this function is only called on the main Dashboard screen * and only when logged in as super-admin. * * @since 1.0.0 * @return object|false * string $plugin WordPress plugin ID? */ protected function choose_plugin() { if ( wp_is_mobile() ) { return false; } /** * list */ $choosen = array(); /** * change time by filter */ $now = apply_filters( 'iworks_rate_set_custom_time', time() ); foreach ( $this->stored as $plugin_id => $item ) { if ( ! isset( $this->plugins[ $plugin_id ] ) ) { if ( isset( $this->stored[ $plugin_id ] ) ) { unset( $this->stored[ $plugin_id ] ); $this->store_data(); } continue; } if ( intval( $item['show_at'] ) > $now ) { continue; } $choosen[] = $plugin_id; } if ( empty( $choosen ) ) { return false; } return $choosen[ array_rand( $choosen ) ]; } /** * Renders the actual Notification message. * * @since 1.0.0 */ protected function render_message( $plugin_id ) { $file = $this->get_file( 'thanks' ); $plugin = $this->get_plugin_data_by_plugin_id( $plugin_id ); load_template( $file, true, $plugin ); } /** * @since 2.0.1 */ private function get_file( $file, $group = '' ) { return sprintf( '%s/templates/%s%s%s.php', dirname( __FILE__ ), $group, '' === $group ? '' : '/', sanitize_title( $file ) ); } /** * @since 2.0.1 */ private function get_plugin_data_by_plugin_id( $plugin_id ) { $plugin = wp_parse_args( $this->plugins[ $plugin_id ], $this->stored[ $plugin_id ] ); $plugin['plugin_id'] = $plugin_id; $plugin['logo'] = apply_filters( 'iworks_rate_notice_logo_style', '', $plugin ); $plugin['ajax_url'] = admin_url( 'admin-ajax.php' ); $plugin['classes'] = array( 'iworks-rate', 'iworks-rate-' . $plugin['slug'], 'iworks-rate-notice', ); if ( ! empty( $plugin['logo'] ) ) { $plugin['classes'][] = 'has-logo'; } $plugin['url'] = esc_url( sprintf( _x( 'https://wordpress.org/plugins/%s', 'plugins home', 'omnibus' ), $plugin['slug'] ) ); $plugin['support_url'] = esc_url( sprintf( _x( 'https://wordpress.org/support/plugin/%s', 'plugins support home', 'omnibus' ), $plugin['slug'] ) ); return $plugin; } /** * @since 2.0.1 */ private function get_plugin_id_by_slug( $slug ) { foreach ( $this->stored as $plugin_id => $plugin ) { if ( $slug === $plugin['slug'] ) { return $plugin_id; } } return new WP_Error(); } /** * @since 2.0.1 */ public function filter_get_assistance_widget( $content, $slug ) { $plugin_id = $this->get_plugin_id_by_slug( $slug ); if ( is_wp_error( $plugin_id ) ) { return $content; } $this->enqueue(); $plugin = $this->get_plugin_data_by_plugin_id( $plugin_id ); $file = $this->get_file( 'support', 'widgets' ); ob_start(); load_template( $file, true, $plugin ); $content = ob_get_contents(); ob_end_clean(); return $content; } /** * @since 2.0.1 */ public function filter_get_love_widget( $content, $slug ) { $plugin_id = $this->get_plugin_id_by_slug( $slug ); if ( is_wp_error( $plugin_id ) ) { return $content; } $this->enqueue(); $plugin = $this->get_plugin_data_by_plugin_id( $plugin_id ); $file = $this->get_file( 'donate', 'widgets' ); ob_start(); load_template( $file, true, $plugin ); $content = ob_get_contents(); ob_end_clean(); return $content; } /** * Get advertising for "OG — Better Share on Social Media" plugin. * * @since 2.1.0 */ public function filter_get_advertising_og( $data ) { return array( 'iworks-adverting-og' => array( 'title' => __( 'OpenGraph', 'omnibus' ), 'callback' => array( $this, 'get_advertising_og_content' ), 'context' => 'side', 'priority' => 'low', ), ); } /** * Advertising content for "OG — Better Share on Social Media" plugin. * * @since 2.1.0 */ public function get_advertising_og_content() { $args = array( 'install_plugin_url' => $this->get_install_plugin_url( 'og' ), 'plugin_name' => __( 'OG — Better Share on Social Media', 'omnibus' ), 'plugin_wp_home' => __( 'https://wordpress.org/plugins/og/', 'omnibus' ), ); $file = $this->get_file( 'og', 'plugins' ); load_template( $file, true, $args ); } /** * get admin plugin install url * * @since 2.1.0 */ private function get_install_plugin_url( $slug ) { return wp_nonce_url( self_admin_url( 'update.php?action=install-plugin&plugin=' . $slug ), 'install-plugin_' . $slug ); } } // Initialize the module. iworks_rate::instance(); }