%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* BSF analytics class file.
*
* @version 1.0.0
*
* @package bsf-analytics
*/
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
if ( ! class_exists( 'BSF_Analytics' ) ) {
/**
* BSF analytics
*/
class BSF_Analytics {
/**
* Member Variable
*
* @var array Entities data.
*/
private $entities;
/**
* Member Variable
*
* @var string Usage tracking document URL
*/
public $usage_doc_link = 'https://store.brainstormforce.com/usage-tracking/?utm_source=wp_dashboard&utm_medium=general_settings&utm_campaign=usage_tracking';
/**
* Setup actions, load files.
*
* @param array $args entity data for analytics.
* @param string $analytics_path directory path to analytics library.
* @param float $analytics_version analytics library version.
* @since 1.0.0
*/
public function __construct( $args, $analytics_path, $analytics_version ) {
// Bail when no analytics entities are registered.
if ( empty( $args ) ) {
return;
}
$this->entities = $args;
define( 'BSF_ANALYTICS_VERSION', $analytics_version );
define( 'BSF_ANALYTICS_URI', $this->get_analytics_url( $analytics_path ) );
add_action( 'admin_init', array( $this, 'handle_optin_optout' ) );
add_action( 'admin_init', array( $this, 'option_notice' ) );
add_action( 'init', array( $this, 'maybe_track_analytics' ), 99 );
$this->set_actions();
add_action( 'admin_init', array( $this, 'register_usage_tracking_setting' ) );
$this->includes();
}
/**
* Setup actions for admin notice style and analytics cron event.
*
* @since 1.0.4
*/
public function set_actions() {
foreach ( $this->entities as $key => $data ) {
add_action( 'astra_notice_before_markup_' . $key . '-optin-notice', array( $this, 'enqueue_assets' ) );
add_action( 'update_option_' . $key . '_analytics_optin', array( $this, 'update_analytics_option_callback' ), 10, 3 );
add_action( 'add_option_' . $key . '_analytics_optin', array( $this, 'add_analytics_option_callback' ), 10, 2 );
}
}
/**
* BSF Analytics URL
*
* @param string $analytics_path directory path to analytics library.
* @return String URL of bsf-analytics directory.
* @since 1.0.0
*/
public function get_analytics_url( $analytics_path ) {
$content_dir_path = wp_normalize_path( WP_CONTENT_DIR );
$analytics_path = wp_normalize_path( $analytics_path );
return str_replace( $content_dir_path, content_url(), $analytics_path );
}
/**
* Get API URL for sending analytics.
*
* @return string API URL.
* @since 1.0.0
*/
private function get_api_url() {
return defined( 'BSF_API_URL' ) ? BSF_API_URL : 'https://support.brainstormforce.com/';
}
/**
* Enqueue Scripts.
*
* @since 1.0.0
* @return void
*/
public function enqueue_assets() {
/**
* Load unminified if SCRIPT_DEBUG is true.
*
* Directory and Extensions.
*/
$dir_name = ( SCRIPT_DEBUG ) ? 'unminified' : 'minified';
$file_rtl = ( is_rtl() ) ? '-rtl' : '';
$css_ext = ( SCRIPT_DEBUG ) ? '.css' : '.min.css';
$css_uri = BSF_ANALYTICS_URI . '/assets/css/' . $dir_name . '/style' . $file_rtl . $css_ext;
wp_enqueue_style( 'bsf-analytics-admin-style', $css_uri, false, BSF_ANALYTICS_VERSION, 'all' );
}
/**
* Send analytics API call.
*
* @since 1.0.0
*/
public function send() {
wp_remote_post(
$this->get_api_url() . 'wp-json/bsf-core/v1/analytics/',
array(
'body' => BSF_Analytics_Stats::instance()->get_stats(),
'blocking' => false,
)
);
}
/**
* Check if usage tracking is enabled.
*
* @return bool
* @since 1.0.0
*/
public function is_tracking_enabled() {
foreach ( $this->entities as $key => $data ) {
$is_enabled = get_site_option( $key . '_analytics_optin' ) === 'yes' ? true : false;
$is_enabled = $this->is_white_label_enabled( $key ) ? false : $is_enabled;
if ( apply_filters( $key . '_tracking_enabled', $is_enabled ) ) {
return true;
}
}
return false;
}
/**
* Check if WHITE label is enabled for BSF products.
*
* @param string $source source of analytics.
* @return bool
* @since 1.0.0
*/
public function is_white_label_enabled( $source ) {
$options = apply_filters( $source . '_white_label_options', array() );
$is_enabled = false;
if ( is_array( $options ) ) {
foreach ( $options as $option ) {
if ( true === $option ) {
$is_enabled = true;
break;
}
}
}
return $is_enabled;
}
/**
* Display admin notice for usage tracking.
*
* @since 1.0.0
*/
public function option_notice() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
foreach ( $this->entities as $key => $data ) {
$time_to_display = isset( $data['time_to_display'] ) ? $data['time_to_display'] : '+24 hours';
$usage_doc_link = isset( $data['usage_doc_link'] ) ? $data['usage_doc_link'] : $this->usage_doc_link;
// Don't display the notice if tracking is disabled or White Label is enabled for any of our plugins.
if ( false !== get_site_option( $key . '_analytics_optin', false ) || $this->is_white_label_enabled( $key ) ) {
continue;
}
// Show tracker consent notice after 24 hours from installed time.
if ( strtotime( $time_to_display, $this->get_analytics_install_time( $key ) ) > time() ) {
continue;
}
/* translators: %s product name */
$notice_string = __( 'Want to help make <strong>%1s</strong> even more awesome? Allow us to collect non-sensitive diagnostic data and usage information. ', 'cartflows' );
if ( is_multisite() ) {
$notice_string .= __( 'This will be applicable for all sites from the network.', 'cartflows' );
}
$language_dir = is_rtl() ? 'rtl' : 'ltr';
Astra_Notices::add_notice(
array(
'id' => $key . '-optin-notice',
'type' => '',
'message' => sprintf(
'<div class="notice-content">
<div class="notice-heading">
%1$s
</div>
<div class="astra-notices-container">
<a href="%2$s" class="astra-notices button-primary">
%3$s
</a>
<a href="%4$s" data-repeat-notice-after="%5$s" class="astra-notices button-secondary">
%6$s
</a>
</div>
</div>',
/* translators: %s usage doc link */
sprintf( $notice_string . '<span dir="%2s"><a href="%3s" target="_blank" rel="noreferrer noopener">%4s</a><span>', esc_html( $data['product_name'] ), $language_dir, esc_url( $usage_doc_link ), __( ' Know More.', 'cartflows' ) ),
esc_url(
add_query_arg(
array(
$key . '_analytics_optin' => 'yes',
$key . '_analytics_nonce' => wp_create_nonce( $key . '_analytics_optin' ),
'bsf_analytics_source' => $key,
)
)
),
__( 'Yes! Allow it', 'cartflows' ),
esc_url(
add_query_arg(
array(
$key . '_analytics_optin' => 'no',
$key . '_analytics_nonce' => wp_create_nonce( $key . '_analytics_optin' ),
'bsf_analytics_source' => $key,
)
)
),
MONTH_IN_SECONDS,
__( 'No Thanks', 'cartflows' )
),
'show_if' => true,
'repeat-notice-after' => false,
'priority' => 18,
'display-with-other-notices' => true,
)
);
}
}
/**
* Process usage tracking opt out.
*
* @since 1.0.0
*/
public function handle_optin_optout() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
$source = isset( $_GET['bsf_analytics_source'] ) ? sanitize_text_field( wp_unslash( $_GET['bsf_analytics_source'] ) ) : '';
if ( ! isset( $_GET[ $source . '_analytics_nonce' ] ) ) {
return;
}
if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_GET[ $source . '_analytics_nonce' ] ) ), $source . '_analytics_optin' ) ) {
return;
}
$optin_status = isset( $_GET[ $source . '_analytics_optin' ] ) ? sanitize_text_field( wp_unslash( $_GET[ $source . '_analytics_optin' ] ) ) : '';
if ( 'yes' === $optin_status ) {
$this->optin( $source );
} elseif ( 'no' === $optin_status ) {
$this->optout( $source );
}
wp_safe_redirect(
esc_url_raw(
remove_query_arg(
array(
$source . '_analytics_optin',
$source . '_analytics_nonce',
'bsf_analytics_source',
)
)
)
);
exit;
}
/**
* Opt in to usage tracking.
*
* @param string $source source of analytics.
* @since 1.0.0
*/
private function optin( $source ) {
update_site_option( $source . '_analytics_optin', 'yes' );
}
/**
* Opt out to usage tracking.
*
* @param string $source source of analytics.
* @since 1.0.0
*/
private function optout( $source ) {
update_site_option( $source . '_analytics_optin', 'no' );
}
/**
* Load analytics stat class.
*
* @since 1.0.0
*/
private function includes() {
require_once __DIR__ . '/class-bsf-analytics-stats.php';
}
/**
* Register usage tracking option in General settings page.
*
* @since 1.0.0
*/
public function register_usage_tracking_setting() {
foreach ( $this->entities as $key => $data ) {
if ( ! apply_filters( $key . '_tracking_enabled', true ) || $this->is_white_label_enabled( $key ) ) {
return;
}
$usage_doc_link = isset( $data['usage_doc_link'] ) ? $data['usage_doc_link'] : $this->usage_doc_link;
$author = isset( $data['author'] ) ? $data['author'] : 'Brainstorm Force';
register_setting(
'general', // Options group.
$key . '_analytics_optin', // Option name/database.
array( 'sanitize_callback' => array( $this, 'sanitize_option' ) ) // sanitize callback function.
);
add_settings_field(
$key . '-analytics-optin', // Field ID.
__( 'Usage Tracking', 'cartflows' ), // Field title.
array( $this, 'render_settings_field_html' ), // Field callback function.
'general',
'default', // Settings page slug.
array(
'type' => 'checkbox',
'title' => $author,
'name' => $key . '_analytics_optin',
'label_for' => $key . '-analytics-optin',
'id' => $key . '-analytics-optin',
'usage_doc_link' => $usage_doc_link,
)
);
}
}
/**
* Sanitize Callback Function
*
* @param bool $input Option value.
* @since 1.0.0
*/
public function sanitize_option( $input ) {
if ( ! $input || 'no' === $input ) {
return 'no';
}
return 'yes';
}
/**
* Print settings field HTML.
*
* @param array $args arguments to field.
* @since 1.0.0
*/
public function render_settings_field_html( $args ) {
?>
<fieldset>
<label for="<?php echo esc_attr( $args['label_for'] ); ?>">
<input id="<?php echo esc_attr( $args['id'] ); ?>" type="checkbox" value="1" name="<?php echo esc_attr( $args['name'] ); ?>" <?php checked( get_site_option( $args['name'], 'no' ), 'yes' ); ?>>
<?php
/* translators: %s Product title */
echo esc_html( sprintf( __( 'Allow %s products to track non-sensitive usage tracking data.', 'cartflows' ), $args['title'] ) );// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText
if ( is_multisite() ) {
esc_html_e( ' This will be applicable for all sites from the network.', 'cartflows' );
}
?>
</label>
<?php
echo wp_kses_post( sprintf( '<a href="%1s" target="_blank" rel="noreferrer noopener">%2s</a>', esc_url( $args['usage_doc_link'] ), __( 'Learn More.', 'cartflows' ) ) );
?>
</fieldset>
<?php
}
/**
* Set analytics installed time in option.
*
* @param string $source source of analytics.
* @return string $time analytics installed time.
* @since 1.0.0
*/
private function get_analytics_install_time( $source ) {
$time = get_site_option( $source . '_analytics_installed_time' );
if ( ! $time ) {
$time = time();
update_site_option( $source . '_analytics_installed_time', time() );
}
return $time;
}
/**
* Schedule/unschedule cron event on updation of option.
*
* @param string $old_value old value of option.
* @param string $value value of option.
* @param string $option Option name.
* @since 1.0.0
*/
public function update_analytics_option_callback( $old_value, $value, $option ) {
if ( is_multisite() ) {
$this->add_option_to_network( $option, $value );
}
}
/**
* Analytics option add callback.
*
* @param string $option Option name.
* @param string $value value of option.
* @since 1.0.0
*/
public function add_analytics_option_callback( $option, $value ) {
if ( is_multisite() ) {
$this->add_option_to_network( $option, $value );
}
}
/**
* Send analaytics track event if tracking is enabled.
*
* @since 1.0.0
*/
public function maybe_track_analytics() {
if ( ! $this->is_tracking_enabled() ) {
return;
}
$analytics_track = get_site_transient( 'bsf_analytics_track' );
// If the last data sent is 2 days old i.e. transient is expired.
if ( ! $analytics_track ) {
$this->send();
set_site_transient( 'bsf_analytics_track', true, 2 * DAY_IN_SECONDS );
}
}
/**
* Save analytics option to network.
*
* @param string $option name of option.
* @param string $value value of option.
* @since 1.0.0
*/
public function add_option_to_network( $option, $value ) {
// If action coming from general settings page.
if ( isset( $_POST['option_page'] ) && 'general' === $_POST['option_page'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
if ( get_site_option( $option ) ) {
update_site_option( $option, $value );
} else {
add_site_option( $option, $value );
}
}
}
}
}
Zerion Mini Shell 1.0