TemplatesNext ToolKit - Version 2.0.5

Version Description

Release Info

Developer	marsian
Plugin	TemplatesNext ToolKit
Version	2.0.5
Comparing to
See all releases

Code changes from version 2.0.4 to 2.0.5

Files changed (3) hide show

inc/class-remote-notification-client.php +856 -0
readme.txt +1 -1
tx-toolkit.php +1 -1

inc/class-remote-notification-client.php ADDED Viewed

	@@ -0,0 +1,856 @@


1	+ <?php
2	+ /**
3	+ * Remote Dashboard Notifications.
4	+ *
5	+ * This class is part of the Remote Dashboard Notifications plugin.
6	+ * This plugin allows you to send notifications to your client's
7	+ * WordPress dashboard easily.
8	+ *
9	+ * Notification you send will be displayed as admin notifications
10	+ * using the standard WordPress hooks. A "dismiss" option is added
11	+ * in order to let the user hide the notification.
12	+ *
13	+ * @package Remote Dashboard Notifications
14	+ * @author ThemeAvenue <web@themeavenue.net>
15	+ * @license GPL-2.0+
16	+ * @link http://themeavenue.net
17	+ * @link http://wordpress.org/plugins/remote-dashboard-notifications/
18	+ * @link https://github.com/ThemeAvenue/Remote-Dashboard-Notifications
19	+ * @copyright 2016 ThemeAvenue
20	+ */
21	+
22	+ // If this file is called directly, abort.
23	+ if ( ! defined( 'WPINC' ) ) {
24	+ die;
25	+ }
26	+
27	+ if ( ! class_exists( 'Remote_Dashboard_Notifications_Client' ) ) {
28	+
29	+ final class Remote_Dashboard_Notifications_Client {
30	+
31	+ /**
32	+ * @var Remote_Dashboard_Notifications_Client Holds the unique instance
33	+ * @since 1.3.0
34	+ */
35	+ private static $instance;
36	+
37	+ /**
38	+ * Minimum version of WordPress required ot run the plugin
39	+ *
40	+ * @since 1.3.0
41	+ * @var string
42	+ */
43	+ public $wordpress_version_required = '3.8';
44	+
45	+ /**
46	+ * Required version of PHP.
47	+ *
48	+ * Follow WordPress latest requirements and require
49	+ * PHP version 5.2 at least.
50	+ *
51	+ * @since 1.3.0
52	+ * @var string
53	+ */
54	+ public $php_version_required = '5.2';
55	+
56	+ /**
57	+ * Holds all the registered notifications
58	+ *
59	+ * @since 1.3.0
60	+ * @var array
61	+ */
62	+ public $notifications = array();
63	+
64	+ /**
65	+ * Instantiate and return the unique object
66	+ *
67	+ * @since 1.2.0
68	+ * @return object Remote_Dashboard_Notifications_Client Unique instance
69	+ */
70	+ public static function instance() {
71	+
72	+ if ( ! isset( self::$instance ) && ! ( self::$instance instanceof Awesome_Support ) ) {
73	+ self::$instance = new Remote_Dashboard_Notifications_Client;
74	+ self::$instance->init();
75	+ }
76	+
77	+ return self::$instance;
78	+
79	+ }
80	+
81	+ /**
82	+ * Instantiate the plugin
83	+ *
84	+ * @since 1.3.0
85	+ * @return void
86	+ */
87	+ private function init() {
88	+
89	+ // Make sure the WordPress version is recent enough
90	+ if ( ! self::$instance->is_version_compatible() ) {
91	+ return;
92	+ }
93	+
94	+ // Make sure we have a version of PHP that's not too old
95	+ if ( ! self::$instance->is_php_version_enough() ) {
96	+ return;
97	+ }
98	+
99	+ // Call the dismiss method before testing for Ajax
100	+ if ( isset( $_GET['rn'] ) && isset( $_GET['notification'] ) ) {
101	+ add_action( 'plugins_loaded', array( self::$instance, 'dismiss' ) );
102	+ }
103	+
104	+ if ( ! defined( 'DOING_AJAX' ) \|\| ! DOING_AJAX ) {
105	+ add_action( 'admin_print_styles', array( self::$instance, 'style' ), 100 );
106	+ add_action( 'admin_notices', array( self::$instance, 'show_notices' ) );
107	+ add_action( 'admin_footer', array( self::$instance, 'script' ) );
108	+ }
109	+
110	+ add_action( 'wp_ajax_rdn_fetch_notifications', array( $this, 'remote_get_notice_ajax' ) );
111	+ add_filter( 'heartbeat_received', array( self::$instance, 'heartbeat' ), 10, 2 );
112	+
113	+ }
114	+
115	+ /**
116	+ * Throw error on object clone
117	+ *
118	+ * The whole idea of the singleton design pattern is that there is a single
119	+ * object therefore, we don't want the object to be cloned.
120	+ *
121	+ * @since 3.2.5
122	+ * @return void
123	+ */
124	+ public function __clone() {
125	+ // Cloning instances of the class is forbidden
126	+ _doing_it_wrong( __FUNCTION__, __( 'Cheatin’ huh?', 'awesome-support' ), '3.2.5' );
127	+ }
128	+
129	+ /**
130	+ * Disable unserializing of the class
131	+ *
132	+ * @since 3.2.5
133	+ * @return void
134	+ */
135	+ public function __wakeup() {
136	+ // Unserializing instances of the class is forbidden
137	+ _doing_it_wrong( __FUNCTION__, __( 'Cheatin’ huh?', 'awesome-support' ), '3.2.5' );
138	+ }
139	+
140	+ /**
141	+ * Check if the core version is compatible with this addon.
142	+ *
143	+ * @since 1.3.0
144	+ * @return boolean
145	+ */
146	+ private function is_version_compatible() {
147	+
148	+ if ( empty( self::$instance->wordpress_version_required ) ) {
149	+ return true;
150	+ }
151	+
152	+ if ( version_compare( get_bloginfo( 'version' ), self::$instance->wordpress_version_required, '<' ) ) {
153	+ return false;
154	+ }
155	+
156	+ return true;
157	+
158	+ }
159	+
160	+ /**
161	+ * Check if the version of PHP is compatible with this addon.
162	+ *
163	+ * @since 1.3.0
164	+ * @return boolean
165	+ */
166	+ private function is_php_version_enough() {
167	+
168	+ /**
169	+ * No version set, we assume everything is fine.
170	+ */
171	+ if ( empty( self::$instance->php_version_required ) ) {
172	+ return true;
173	+ }
174	+
175	+ if ( version_compare( phpversion(), self::$instance->php_version_required, '<' ) ) {
176	+ return false;
177	+ }
178	+
179	+ return true;
180	+
181	+ }
182	+
183	+ /**
184	+ * Register a new remote notification
185	+ *
186	+ * @since 1.3.0
187	+ *
188	+ * @param int $channel_id Channel ID on the remote server
189	+ * @param string $channel_key Channel key for authentication with the server
190	+ * @param string $server Notification server URL
191	+ * @param int $cache Cache lifetime (in hours)
192	+ *
193	+ * @return bool\|string
194	+ */
195	+ public function add_notification( $channel_id, $channel_key, $server, $cache = 6 ) {
196	+
197	+ $notification = array(
198	+ 'channel_id' => (int) $channel_id,
199	+ 'channel_key' => $channel_key,
200	+ 'server_url' => esc_url( $server ),
201	+ 'cache_lifetime' => apply_filters( 'rn_notice_caching_time', $cache ),
202	+ );
203	+
204	+ // Generate the notice unique ID
205	+ $notification['notice_id'] = $notification['channel_id'] . substr( $channel_key, 0, 5 );
206	+
207	+ // Double check that the required info is here
208	+ if ( '' === ( $notification['channel_id'] \|\| $notification['channel_key'] \|\| $notification['server_url'] ) ) {
209	+ return false;
210	+ }
211	+
212	+ // Check that there is no notification with the same ID
213	+ if ( array_key_exists( $notification['notice_id'], $this->notifications ) ) {
214	+ return false;
215	+ }
216	+
217	+ $this->notifications[ $notification['notice_id'] ] = $notification;
218	+
219	+ return $notification['notice_id'];
220	+
221	+ }
222	+
223	+ /**
224	+ * Remove a registered notification
225	+ *
226	+ * @since 1.3.0
227	+ *
228	+ * @param string $notice_id ID of the notice to remove
229	+ *
230	+ * @return void
231	+ */
232	+ public function remove_notification( $notice_id ) {
233	+ if ( array_key_exists( $notice_id, $this->notifications ) ) {
234	+ unset( $this->notifications[ $notice_id ] );
235	+ }
236	+ }
237	+
238	+ /**
239	+ * Get all registered notifications
240	+ *
241	+ * @since 1.3.0
242	+ * @return array
243	+ */
244	+ public function get_notifications() {
245	+ return $this->notifications;
246	+ }
247	+
248	+ /**
249	+ * Get a specific notification
250	+ *
251	+ * @since 1.3.0
252	+ *
253	+ * @param string $notice_id ID of the notice to retrieve
254	+ *
255	+ * @return bool\|array
256	+ */
257	+ public function get_notification( $notice_id ) {
258	+
259	+ if ( ! array_key_exists( $notice_id, $this->notifications ) ) {
260	+ return false;
261	+ }
262	+
263	+ return $this->notifications[ $notice_id ];
264	+ }
265	+
266	+ /**
267	+ * Adds inline style for non standard notices
268	+ *
269	+ * This function will only be called if the notice style is not standard.
270	+ *
271	+ * @since 0.1.0
272	+ */
273	+ public function style() { ?>
274	+ <style type="text/css">div.rn-alert{padding:15px 35px 15px 15px;margin-bottom:20px;border:1px solid transparent;-webkit-box-shadow:none;box-shadow:none}div.rn-alert p:empty{display:none}div.rn-alert ol,div.rn-alert ol li,div.rn-alert ul,div.rn-alert ul li{list-style:inherit!important}div.rn-alert ol,div.rn-alert ul{padding-left:30px}div.rn-alert hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0;margin-top:20px;margin-bottom:20px;border:0;border-top:1px solid #eee}div.rn-alert h1,h2,h3,h4,h5,h6{margin-top:0;color:inherit}div.rn-alert a{font-weight:700}div.rn-alert a:hover{text-decoration:underline}div.rn-alert>p{margin:0;padding:0;line-height:1}div.rn-alert>p,div.rn-alert>ul{margin-bottom:0}div.rn-alert>p+p{margin-top:5px}div.rn-alert .rn-dismiss-btn{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;position:relative;top:-2px;right:-21px;padding:0;cursor:pointer;background:0;border:0;-webkit-appearance:none;float:right;font-size:21px;font-weight:700;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.2;filter:alpha(opacity=20);text-decoration:none}div.rn-alert-success{background-color:#dff0d8;border-color:#d6e9c6;color:#3c763d}div.rn-alert-success hr{border-top-color:#c9e2b3}div.rn-alert-success a{color:#2b542c}div.rn-alert-info{background-color:#d9edf7;border-color:#bce8f1;color:#31708f}div.rn-alert-info hr{border-top-color:#a6e1ec}div.rn-alert-info a{color:#245269}div.rn-alert-warning{background-color:#fcf8e3;border-color:#faebcc;color:#8a6d3b}div.rn-alert-warning hr{border-top-color:#f7e1b5}div.rn-alert-warning a{color:#66512c}div.rn-alert-danger{background-color:#f2dede;border-color:#ebccd1;color:#a94442}div.rn-alert-danger hr{border-top-color:#e4b9c0}div.rn-alert-danger a{color:#843534}</style>
275	+ <?php }
276	+
277	+ /**
278	+ * Display all the registered and available notifications
279	+ *
280	+ * @since 1.3.0
281	+ * @return void
282	+ */
283	+ public function show_notices() {
284	+
285	+ foreach ( $this->notifications as $id => $notification ) {
286	+
287	+ $rn = $this->get_remote_notification( $notification );
288	+
289	+ if ( empty( $rn ) \|\| is_wp_error( $rn ) ) {
290	+ continue;
291	+ }
292	+
293	+ if ( $this->is_notification_error( $rn ) ) {
294	+ continue;
295	+ }
296	+
297	+ if ( $this->is_notice_dismissed( $rn->slug ) ) {
298	+ continue;
299	+ }
300	+
301	+ if ( $this->is_post_type_restricted( $rn ) ) {
302	+ continue;
303	+ }
304	+
305	+ if ( ! $this->is_notification_started( $rn ) ) {
306	+ continue;
307	+ }
308	+
309	+ if ( $this->has_notification_ended( $rn ) ) {
310	+ continue;
311	+ }
312	+
313	+ // Output the admin notice
314	+ $this->create_admin_notice( $rn->message, $this->get_notice_class( isset( $rn->style ) ? $rn->style : 'updated' ), $this->get_notice_dismissal_url( $rn->slug ) );
315	+
316	+ }
317	+
318	+ }
319	+
320	+ /**
321	+ * Check if the notification has been dismissed
322	+ *
323	+ * @since 1.2.0
324	+ *
325	+ * @param string $slug Slug of the notice to check
326	+ *
327	+ * @return bool
328	+ */
329	+ protected function is_notice_dismissed( $slug ) {
330	+
331	+ global $current_user;
332	+
333	+ $dismissed = array_filter( (array) get_user_meta( $current_user->ID, '_rn_dismissed', true ) );
334	+
335	+ if ( is_array( $dismissed ) && in_array( $slug, $dismissed ) ) {
336	+ return true;
337	+ }
338	+
339	+ return false;
340	+
341	+ }
342	+
343	+ /**
344	+ * Check if the notification can be displayed for the current post type
345	+ *
346	+ * @since 1.2.0
347	+ *
348	+ * @param stdClass $notification The notification object
349	+ *
350	+ * @return bool
351	+ */
352	+ protected function is_post_type_restricted( $notification ) {
353	+
354	+ /* If the type array isn't empty we have a limitation */
355	+ if ( isset( $notification->type ) && is_array( $notification->type ) && ! empty( $notification->type ) ) {
356	+
357	+ /* Get current post type */
358	+ $pt = get_post_type();
359	+
360	+ /**
361	+ * If the current post type can't be retrieved
362	+ * or if it's not in the allowed post types,
363	+ * then we don't display the admin notice.
364	+ */
365	+ if ( false === $pt \|\| ! in_array( $pt, $notification->type ) ) {
366	+ return true;
367	+ }
368	+
369	+ }
370	+
371	+ return false;
372	+
373	+ }
374	+
375	+ /**
376	+ * Check if the notification has started yet
377	+ *
378	+ * @since 1.2.0
379	+ *
380	+ * @param stdClass $notification The notification object
381	+ *
382	+ * @return bool
383	+ */
384	+ protected function is_notification_started( $notification ) {
385	+
386	+ if ( ! isset( $notification->date_start ) ) {
387	+ return true;
388	+ }
389	+
390	+ if ( empty( $notification->date_start ) \|\| strtotime( $notification->date_start ) < time() ) {
391	+ return true;
392	+ }
393	+
394	+ return false;
395	+
396	+ }
397	+
398	+ /**
399	+ * Check if the notification has expired
400	+ *
401	+ * @since 1.2.0
402	+ *
403	+ * @param stdClass $notification The notification object
404	+ *
405	+ * @return bool
406	+ */
407	+ protected function has_notification_ended( $notification ) {
408	+
409	+ if ( ! isset( $notification->date_end ) ) {
410	+ return false;
411	+ }
412	+
413	+ if ( empty( $notification->date_end ) \|\| strtotime( $notification->date_end ) > time() ) {
414	+ return false;
415	+ }
416	+
417	+ return true;
418	+
419	+ }
420	+
421	+ /**
422	+ * Get the remote notification object
423	+ *
424	+ * @since 1.3.0
425	+ *
426	+ * @param array $notification The notification data array
427	+ *
428	+ * @return object\|false
429	+ */
430	+ protected function get_remote_notification( $notification ) {
431	+
432	+ $content = get_transient( 'rn_last_notification_' . $notification['notice_id'] );
433	+
434	+ if ( false === $content ) {
435	+ add_option( 'rdn_fetch_' . $notification['notice_id'], 'fetch' );
436	+ }
437	+
438	+ return $content;
439	+
440	+ }
441	+
442	+ /**
443	+ * Get the admin notice class attribute
444	+ *
445	+ * @since 1.3.0
446	+ *
447	+ * @param string $style Notification style
448	+ *
449	+ * @return string
450	+ */
451	+ protected function get_notice_class( $style ) {
452	+
453	+ switch ( $style ) {
454	+ case 'updated':
455	+ $class = $style;
456	+ break;
457	+
458	+ case 'error':
459	+ $class = 'updated error';
460	+ break;
461	+
462	+ default:
463	+ $class = "updated rn-alert rn-alert-$style";
464	+ }
465	+
466	+ return $class;
467	+
468	+ }
469	+
470	+ /**
471	+ * Prepare the dismissal URL for the notice
472	+ *
473	+ * @since 1.3.0
474	+ *
475	+ * @param string $slug Notice slug
476	+ *
477	+ * @return string
478	+ */
479	+ protected function get_notice_dismissal_url( $slug ) {
480	+
481	+ $args = $_GET;
482	+ $args['rn'] = wp_create_nonce( 'rn-dismiss' );
483	+ $args['notification'] = trim( $slug );
484	+
485	+ return esc_url( add_query_arg( $args, '' ) );
486	+
487	+ }
488	+
489	+ /**
490	+ * Create the actual admin notice
491	+ *
492	+ * @since 1.3.0
493	+ *
494	+ * @param string $contents Notice contents
495	+ * @param string $class Wrapper class
496	+ * @param string $dismiss Dismissal link
497	+ *
498	+ * @return void
499	+ */
500	+ protected function create_admin_notice( $contents, $class, $dismiss ) { ?>
501	+ <div class="<?php echo $class; ?>">
502	+ <a href="<?php echo $dismiss; ?>" id="rn-dismiss" class="rn-dismiss-btn" title="<?php _e( 'Dismiss notification', 'remote-notifications' ); ?>">×</a>
503	+ <p><?php echo html_entity_decode( $contents ); ?></p>
504	+ </div>
505	+ <?php }
506	+
507	+ /**
508	+ * Dismiss notice
509	+ *
510	+ * When the user dismisses a notice, its slug
511	+ * is added to the _rn_dismissed entry in the DB options table.
512	+ * This entry is then used to check if a notie has been dismissed
513	+ * before displaying it on the dashboard.
514	+ *
515	+ * @since 0.1.0
516	+ */
517	+ public function dismiss() {
518	+
519	+ global $current_user;
520	+
521	+ /* Check if we have all the vars */
522	+ if ( ! isset( $_GET['rn'] ) \|\| ! isset( $_GET['notification'] ) ) {
523	+ return;
524	+ }
525	+
526	+ /* Validate nonce */
527	+ if ( ! wp_verify_nonce( sanitize_key( $_GET['rn'] ), 'rn-dismiss' ) ) {
528	+ return;
529	+ }
530	+
531	+ /* Get dismissed list */
532	+ $dismissed = array_filter( (array) get_user_meta( $current_user->ID, '_rn_dismissed', true ) );
533	+
534	+ /* Add the current notice to the list if needed */
535	+ if ( is_array( $dismissed ) && ! in_array( $_GET['notification'], $dismissed ) ) {
536	+ array_push( $dismissed, $_GET['notification'] );
537	+ }
538	+
539	+ /* Update option */
540	+ update_user_meta( $current_user->ID, '_rn_dismissed', $dismissed );
541	+
542	+ }
543	+
544	+ /**
545	+ * Adds the script that hooks into the Heartbeat API
546	+ *
547	+ * @since 1.3.0
548	+ * @return void
549	+ */
550	+ public function script() {
551	+
552	+ $maybe_fetch = array();
553	+
554	+ foreach ( $this->get_notifications() as $id => $n ) {
555	+ $maybe_fetch[] = (string) $id;
556	+ } ?>
557	+
558	+ <script type="text/javascript">
559	+ jQuery(document).ready(function ($) {
560	+
561	+ // Hook into the heartbeat-send
562	+ $(document).on('heartbeat-send', function (e, data) {
563	+ data['rdn_maybe_fetch'] = <?php echo json_encode( $maybe_fetch ); ?>;
564	+ });
565	+
566	+ // Listen for the custom event "heartbeat-tick" on $(document).
567	+ $(document).on('heartbeat-tick', function (e, data) {
568	+
569	+ if (data.rdn_fetch !== '') {
570	+
571	+ ajax_data = {
572	+ 'action': 'rdn_fetch_notifications',
573	+ 'notices': data.rdn_fetch
574	+ };
575	+
576	+ $.post(ajaxurl, ajax_data);
577	+
578	+ }
579	+
580	+ });
581	+ });
582	+ </script>
583	+
584	+ <?php }
585	+
586	+ /**
587	+ * Hook into the Heartbeat API.
588	+ *
589	+ * @since 1.3.0
590	+ *
591	+ * @param array $response Heartbeat tick response
592	+ * @param array $data Heartbeat tick data
593	+ *
594	+ * @return array Updated Heartbeat tick response
595	+ */
596	+ function heartbeat( $response, $data ) {
597	+
598	+ if ( isset( $data['rdn_maybe_fetch'] ) ) {
599	+
600	+ $notices = $data['rdn_maybe_fetch'];
601	+
602	+ if ( ! is_array( $notices ) ) {
603	+ $notices = array( $notices );
604	+ }
605	+
606	+ foreach ( $notices as $notice_id ) {
607	+
608	+ $fetch = get_option( "rdn_fetch_$notice_id", false );
609	+
610	+ if ( 'fetch' === $fetch ) {
611	+
612	+ if ( ! isset( $response['rdn_fetch'] ) ) {
613	+ $response['rdn_fetch'] = array();
614	+ }
615	+
616	+ $response['rdn_fetch'][] = $notice_id;
617	+
618	+ }
619	+
620	+ }
621	+
622	+ }
623	+
624	+ return $response;
625	+
626	+ }
627	+
628	+ /**
629	+ * Triggers the remote requests that fetches notices for this particular instance
630	+ *
631	+ * @since 1.3.0
632	+ * @return void
633	+ */
634	+ public function remote_get_notice_ajax() {
635	+
636	+ if ( isset( $_POST['notices'] ) ) {
637	+ $notices = $_POST['notices'];
638	+ } else {
639	+ echo 'No notice ID';
640	+ die();
641	+ }
642	+
643	+ if ( ! is_array( $notices ) ) {
644	+ $notices = array( $notices );
645	+ }
646	+
647	+ foreach ( $notices as $notice_id ) {
648	+
649	+ $notification = $this->get_notification( $notice_id );
650	+ $rn = $this->remote_get_notification( $notification );
651	+
652	+ if ( is_wp_error( $rn ) ) {
653	+ echo $rn->get_error_message();
654	+ } else {
655	+ echo json_encode( $rn );
656	+ }
657	+
658	+ }
659	+
660	+ die();
661	+
662	+ }
663	+
664	+ /**
665	+ * Get the remote server URL
666	+ *
667	+ * @since 1.2.0
668	+ *
669	+ * @param string $url THe server URL to sanitize
670	+ *
671	+ * @return string
672	+ */
673	+ protected function get_remote_url( $url ) {
674	+
675	+ $url = explode( '?', $url );
676	+
677	+ return esc_url( $url[0] );
678	+
679	+ }
680	+
681	+ /**
682	+ * Maybe get a notification from the remote server
683	+ *
684	+ * @since 1.2.0
685	+ *
686	+ * @param array $notification The notification data array
687	+ *
688	+ * @return string\|WP_Error
689	+ */
690	+ protected function remote_get_notification( $notification ) {
691	+
692	+ /* Query the server */
693	+ $response = wp_remote_get( $this->build_query_url( $notification['server_url'], $this->get_payload( $notification ) ), array( 'timeout' => apply_filters( 'rn_http_request_timeout', 5 ) ) );
694	+
695	+ /* If we have a WP_Error object we abort */
696	+ if ( is_wp_error( $response ) ) {
697	+ return $response;
698	+ }
699	+
700	+ if ( 200 !== (int) wp_remote_retrieve_response_code( $response ) ) {
701	+ return new WP_Error( 'invalid_response', sprintf( __( 'The server response was invalid (code %s)', 'remote-notifications' ), wp_remote_retrieve_response_code( $response ) ) );
702	+ }
703	+
704	+ $body = wp_remote_retrieve_body( $response );
705	+
706	+ if ( empty( $body ) ) {
707	+ return new WP_Error( 'empty_response', __( 'The server response is empty', 'remote-notifications' ) );
708	+ }
709	+
710	+ $body = json_decode( $body );
711	+
712	+ if ( is_null( $body ) ) {
713	+ return new WP_Error( 'json_decode_error', __( 'Cannot decode the response content', 'remote-notifications' ) );
714	+ }
715	+
716	+ set_transient( 'rn_last_notification_' . $notification['notice_id'], $body, $notification['cache_lifetime'] * 60 * 60 );
717	+ delete_option( 'rdn_fetch_' . $notification['notice_id'] );
718	+
719	+ if ( $this->is_notification_error( $body ) ) {
720	+ return new WP_Error( 'notification_error', $this->get_notification_error_message( $body ) );
721	+ }
722	+
723	+ return $body;
724	+
725	+ }
726	+
727	+ /**
728	+ * Check if the notification returned by the server is an error
729	+ *
730	+ * @since 1.2.0
731	+ *
732	+ * @param object $notification Notification returned
733	+ *
734	+ * @return bool
735	+ */
736	+ protected function is_notification_error( $notification ) {
737	+
738	+ if ( false === $this->get_notification_error_message( $notification ) ) {
739	+ return false;
740	+ }
741	+
742	+ return true;
743	+
744	+ }
745	+
746	+ /**
747	+ * Get the error message returned by the remote server
748	+ *
749	+ * @since 1.2.0
750	+ *
751	+ * @param object $notification Notification returned
752	+ *
753	+ * @return bool\|string
754	+ */
755	+ protected function get_notification_error_message( $notification ) {
756	+
757	+ if ( ! is_object( $notification ) ) {
758	+ return false;
759	+ }
760	+
761	+ if ( ! isset( $notification->error ) ) {
762	+ return false;
763	+ }
764	+
765	+ return sanitize_text_field( $notification->error );
766	+
767	+ }
768	+
769	+ /**
770	+ * Get the payload required for querying the remote server
771	+ *
772	+ * @since 1.2.0
773	+ *
774	+ * @param array $notification The notification data array
775	+ *
776	+ * @return string
777	+ */
778	+ protected function get_payload( $notification ) {
779	+ return base64_encode( json_encode( array(
780	+ 'channel' => $notification['channel_id'],
781	+ 'key' => $notification['channel_key']
782	+ ) ) );
783	+ }
784	+
785	+ /**
786	+ * Get the full URL used for the remote get
787	+ *
788	+ * @since 1.2.0
789	+ *
790	+ * @param string $url The remote server URL
791	+ * @param string $payload The encoded payload
792	+ *
793	+ * @return string
794	+ */
795	+ protected function build_query_url( $url, $payload ) {
796	+ return add_query_arg( array(
797	+ 'post_type' => 'notification',
798	+ 'payload' => $payload
799	+ ), $this->get_remote_url( $url ) );
800	+ }
801	+
802	+ }
803	+
804	+ }
805	+
806	+ /**
807	+ * The main function responsible for returning the unique RDN client
808	+ *
809	+ * Use this function like you would a global variable, except without needing
810	+ * to declare the global.
811	+ *
812	+ * @since 1.3.0
813	+ * @return object Remote_Dashboard_Notifications_Client
814	+ */
815	+ function RDNC() {
816	+ return Remote_Dashboard_Notifications_Client::instance();
817	+ }
818	+
819	+ // Get Awesome Support Running
820	+ RDNC();
821	+
822	+ /**
823	+ * Register a new remote notification
824	+ *
825	+ * Helper function for registering new notifications through the Remote_Dashboard_Notifications_Client class
826	+ *
827	+ * @since 1.3.0
828	+ *
829	+ * @param int $channel_id Channel ID on the remote server
830	+ * @param string $channel_key Channel key for authentication with the server
831	+ * @param string $server Notification server URL
832	+ * @param int $cache Cache lifetime (in hours)
833	+ *
834	+ * @return bool\|string
835	+ */
836	+ function tx_add_notification( $channel_id, $channel_key, $server, $cache = 6 ) {
837	+ return RDNC()->add_notification( $channel_id, $channel_key, $server, $cache );
838	+ }
839	+
840	+ if ( ! class_exists( 'TAV_Remote_Notification_Client' ) ) {
841	+
842	+ /**
843	+ * Class TAV_Remote_Notification_Client
844	+ *
845	+ * This class, even though deprecated, is kept here for backwards compatibility. It is now just a wrapper for the new notification registration method.
846	+ *
847	+ * @deprecated @1.3.0
848	+ */
849	+ class TAV_Remote_Notification_Client {
850	+
851	+ public function __construct( $channel_id = false, $channel_key = false, $server = false ) {
852	+ tx_add_notification( $channel_id, $channel_key, $server );
853	+ }
854	+ }
855	+
856	+ }

readme.txt CHANGED Viewed

	@@ -4,7 +4,7 @@ Contributors: marsian
4	Tags: shortcode, shortcodes, columns, column, section, sections, portfolio, testimonial, border, borders, button, buttons, masonry, posts, post_type, font awesome, icons, fontawesome
5	Requires at least: 3.6
6	Tested up to: 4.7
7	- Stable tag: 2.0.4
8	License: GPLv2 or later
9	License URI: http://www.gnu.org/licenses/gpl-2.0.html
10


4	Tags: shortcode, shortcodes, columns, column, section, sections, portfolio, testimonial, border, borders, button, buttons, masonry, posts, post_type, font awesome, icons, fontawesome
5	Requires at least: 3.6
6	Tested up to: 4.7
7	+ Stable tag: 2.0.5
8	License: GPLv2 or later
9	License URI: http://www.gnu.org/licenses/gpl-2.0.html
10

tx-toolkit.php CHANGED Viewed

	@@ -3,7 +3,7 @@
3	/*
4	Plugin Name: TemplatesNext ToolKit
5	Description: Custom Portfolio and Shortcode functionality for TemplatesNext Wordpress Themes
6	- Version: 2.0.4
7	Author: TemplatesNext
8	Author URI: http://templatesnext.org/
9	License: GPLv2 or later


3	/*
4	Plugin Name: TemplatesNext ToolKit
5	Description: Custom Portfolio and Shortcode functionality for TemplatesNext Wordpress Themes
6	+ Version: 2.0.5
7	Author: TemplatesNext
8	Author URI: http://templatesnext.org/
9	License: GPLv2 or later