nps_survey_helper.php — Appointment Booking Plugin – LatePoint | Calendar & Scheduling for WordPress 5.6.8

latepoint / lib / helpers / nps_survey_helper.php

latepoint / lib / helpers Last commit date

nps_survey_helper.php

194 lines

1	<?php
2	/**
3	* LatePoint NPS Survey Helper.
4	*
5	* @since 5.2.8
6	* @package LatePoint
7	*/
8
9	if ( ! defined( 'ABSPATH' ) ) {
10	exit;
11	}
12
13	if ( ! class_exists( 'OsNpsSurveyHelper' ) ) {
14	/**
15	* OsNpsSurveyHelper - NPS Survey Version Checker and Loader
16	*/
17	class OsNpsSurveyHelper {
18
19	/**
20	* Instance of this class.
21	*
22	* @var OsNpsSurveyHelper
23	*/
24	private static $instance = null;
25
26	/**
27	* Array of allowed screens where the NPS survey should be displayed.
28	* This ensures that the NPS survey is only displayed on LatePoint pages.
29	*
30	* @var array
31	*/
32	private static $allowed_screens = [
33	'toplevel_page_latepoint',
34	];
35
36	/**
37	* Get instance.
38	*
39	* @return OsNpsSurveyHelper
40	*/
41	public static function get_instance() {
42	if ( null === self::$instance ) {
43	self::$instance = new self();
44	}
45	return self::$instance;
46	}
47
48	/**
49	* Constructor.
50	*/
51	private function __construct() {
52	$this->version_check();
53	add_action( 'init', [ $this, 'load' ], 999 );
54
55	add_action( 'admin_footer', [ $this, 'show_nps_notice' ], 999 );
56	add_filter( 'nps_survey_post_data', [ $this, 'update_nps_survey_post_data' ] );
57	}
58
59	/**
60	* Version Check
61	*
62	* @return void
63	*/
64	public function version_check() {
65	$file = realpath( LATEPOINT_ABSPATH . '/lib/kit/nps-survey/version.json' );
66
67	// Is file exist?
68	if ( is_file( $file ) ) {
69	// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
70	$file_data = json_decode( file_get_contents( $file ), true );
71	global $nps_survey_version, $nps_survey_init;
72	$path = realpath( LATEPOINT_ABSPATH . '/lib/kit/nps-survey/nps-survey.php' );
73	$version = isset( $file_data['nps-survey'] ) ? $file_data['nps-survey'] : 0;
74
75	if ( null === $nps_survey_version ) {
76	$nps_survey_version = '1.0.0';
77	}
78
79	// Compare versions.
80	if ( version_compare( $version, $nps_survey_version, '>=' ) ) {
81	$nps_survey_version = $version;
82	$nps_survey_init = $path;
83	}
84	}
85	}
86
87	/**
88	* Load latest plugin
89	*
90	* @return void
91	*/
92	public function load() {
93	global $nps_survey_version, $nps_survey_init;
94
95	if ( is_file( realpath( $nps_survey_init ) ) ) {
96	include_once realpath( $nps_survey_init );
97	}
98	}
99
100	/**
101	* Count the number of bookings and determine if NPS survey should be shown.
102	*
103	* @return bool
104	*/
105	public function maybe_display_nps_survey() {
106	// Check if user has manage_options capability.
107	if ( ! current_user_can( 'manage_options' ) ) {
108	return false;
109	}
110
111	// Get total bookings count.
112	$bookings_model = new OsBookingModel();
113	$bookings_count = $bookings_model->count();
114
115	// Get total customers count.
116	$customers_model = new OsCustomerModel();
117	$customers_count = $customers_model->count();
118
119	// Show the NPS survey if there are at least 5 bookings or 3 customers.
120	if ( $bookings_count >= 3 \|\| $customers_count >= 3 ) {
121	return true;
122	}
123
124	return false;
125	}
126
127	/**
128	* Render NPS Survey
129	*
130	* @return void
131	*/
132	public function show_nps_notice() {
133	// Ensure the Nps_Survey class exists before proceeding.
134	if ( ! class_exists( 'Nps_Survey' ) ) {
135	return;
136	}
137
138	// Get current screen.
139	$screen = get_current_screen();
140	if ( ! $screen \|\| ! in_array( $screen->id, self::$allowed_screens, true ) ) {
141	return;
142	}
143
144	// Check if the constant WEEK_IN_SECONDS is already defined.
145	if ( ! defined( 'WEEK_IN_SECONDS' ) ) {
146	define( 'WEEK_IN_SECONDS', 604800 );
147	}
148
149	// Display the NPS survey.
150	Nps_Survey::show_nps_notice(
151	'nps-survey-latepoint',
152	[
153	'show_if' => $this->maybe_display_nps_survey(),
154	'dismiss_timespan' => 2 * WEEK_IN_SECONDS,
155	'display_after' => 0,
156	'plugin_slug' => 'latepoint',
157	'show_on_screens' => self::$allowed_screens,
158	'message' => [
159	'logo' => esc_url( LATEPOINT_IMAGES_URL . 'logo.png' ),
160	'plugin_name' => __( 'Quick Question!', 'latepoint' ),
161	'nps_rating_message' => __( 'How would you rate LatePoint? Love it, hate it, or somewhere in between? Your honest answer helps us understand how we\'re doing.', 'latepoint' ),
162	'feedback_title' => __( 'Thanks a lot for your feedback!', 'latepoint' ),
163	'feedback_content' => __( 'Thanks for being part of the LatePoint community! Got feedback or suggestions? We\'d love to hear it.', 'latepoint' ),
164	'plugin_rating_link' => esc_url( 'https://wordpress.org/support/plugin/latepoint/reviews/#new-post' ),
165	'plugin_rating_title' => __( 'Thank you for your feedback', 'latepoint' ),
166	'plugin_rating_content' => __( 'We value your input. How can we improve your experience?', 'latepoint' ),
167	'plugin_rating_button_string' => __( 'Rate LatePoint', 'latepoint' ),
168	'rating_min_label' => __( 'Hate it!', 'latepoint' ),
169	'rating_max_label' => __( 'Love it!', 'latepoint' ),
170	],
171	'privacy_policy' => [
172	'url' => 'https://latepoint.com/privacy-policy',
173	],
174	]
175	);
176	}
177
178	/**
179	* Update the NPS survey post data.
180	* Add LatePoint plugin version to the NPS survey post data.
181	*
182	* @param array $post_data NPS survey post data.
183	* @return array
184	*/
185	public function update_nps_survey_post_data( $post_data ) {
186	if ( isset( $post_data['plugin_slug'] ) && 'latepoint' === $post_data['plugin_slug'] ) {
187	$post_data['plugin_version'] = LATEPOINT_VERSION;
188	}
189
190	return $post_data;
191	}
192	}
193	}
194