?AlkantarClanX12
Your IP : 216.73.216.177
<?php
declare(strict_types=1);
namespace WPMedia\BackWPup\Admin\Beacon;
use Inpsyde\BackWPup\Pro\License\License;
use WPMedia\BackWPup\Common\AbstractRender;
class Beacon extends AbstractRender {
/**
* Returns the link for corresponding section.
* TODO:: Add language option, we could have separate link for diff languages.
*
* @since 5.4
*
* @param string $doc_id Section identifier. Available values:
* - 'include_extra_files'
* - 'file_format'
* - 'user_account'
* - 'contact_support'.
* @param bool $is_tracked Whether to add tracking data to the URL.
* @param array $track_data Tracking data to append to the URL.
* Format structure:
* [
* 'bwu_event' => string, // Required. The event name to track
* 'property1' => string|int, // Optional. Custom event property
* 'property2' => string|int, // Optional. Additional event property
* // ... more properties
* ]
*
* Examples:
* - Simple tracking:
* ['bwu_event' => 'help_clicked']
*
* - With properties:
* [
* 'bwu_event' => 'support_link_clicked',
* 'page' => 'job_edit',
* 'user_type' => 'pro',
* 'job_id' => 123
* ]
*
* Note: All properties except 'bwu_event' will be
* automatically prefixed with 'bwu_event_property_'.
*
* @return string|array
*/
public function get_suggest( string $doc_id, bool $is_tracked = false, array $track_data = [] ): array {
$suggest = [
'include_extra_files' => [
'url' => 'https://backwpup.com/backwpup-5-4/',
'title' => __( 'Welcome to BackWPup 5.4!', 'backwpup' ),
],
'file_format' => [
'url' => 'https://backwpup.com/backwpup-5-5/',
'title' => __( 'BackWPup 5.5 is here!', 'backwpup' ),
],
'user_account' => [
'url' => 'https://backwpup.com/my-account/?utm_source=backwpup_plugin&utm_medium=plugin&utm_campaign=in_product&utm_content=my_account',
'title' => __( 'Manage your BackWPup license', 'backwpup' ),
],
'update-payment-method' => [
'url' => 'https://backwpup.com/my-account/add-payment-method/?utm_source=backwpup_plugin&utm_medium=plugin&utm_campaign=in_product&utm_content=upgrade_cta_plugin',
'title' => __( 'Manage your BackWPup license', 'backwpup' ),
],
'contact_support' => [
'url' => 'https://backwpup.com/contact/?utm_source=backwpup_plugin&utm_medium=plugin&utm_campaign=in_product&utm_content=get_contact',
'title' => __( 'Contact BackWPup support', 'backwpup' ),
],
];
// change urls by license server.
if ( class_exists( License::class ) && License::WC_API_URL === 'https://backwpup.de/' ) {
$suggest['user_account']['url'] = 'https://backwpup.de/mein-account/';
$suggest['update-payment-method']['url'] = 'https://backwpup.de/mein-account/add-payment-method/';
}
$language = get_user_locale();
// update suggestions to german webseite urls.
if ( 'de' === substr( $language, 0, 2 ) ) {
$suggest['contact_support']['url'] = 'https://backwpup.de/kontakt/';
}
$selected_suggest = $suggest[ $doc_id ] ?? [];
// Apply filter on the URL if set.
if ( isset( $selected_suggest['url'] ) ) {
$selected_suggest['url'] = wpm_apply_filters_typed( 'string', 'backwpup_url_add_hash', $selected_suggest['url'] );
}
// Add tracking data if required using the redirect.
if ( ! empty( $selected_suggest ) && $is_tracked ) {
// Prefix all keys with 'bwu_event_property_' except 'bwu_event'.
$prefixed_track_data = [];
foreach ( $track_data as $key => $value ) {
if ( 'bwu_event' === $key ) {
$prefixed_track_data[ $key ] = $value;
} else {
$prefixed_track_data[ 'bwu_event_property_' . $key ] = $value;
}
}
$selected_suggest['url'] = add_query_arg(
$prefixed_track_data,
'?bwu_redirect=' . $selected_suggest['url']
);
// Add nonce for security.
$selected_suggest['url'] = wp_nonce_url( $selected_suggest['url'], 'backwpup_redirect_nonce' );
}
return $selected_suggest;
}
}