????
Your IP : 216.73.216.79
<?php
/**
* Support Chat Widget
*
* Displays a chat-like popup showing recent WordPress.org forum topics
* and encourages users to open support tickets.
*
* @package TranslatePress
* @since 3.0.9
*/
if ( ! defined( 'ABSPATH' ) ) exit;
/**
* Class TRP_Support_Chat
*
* Handles the support chat widget functionality
*/
class TRP_Support_Chat {
/**
* RSS Feed URL for the plugin support forum
*/
const FEED_URL = 'https://wordpress.org/support/plugin/translatepress-multilingual/feed/';
/**
* Support forum URL
*/
const FORUM_URL = 'https://wordpress.org/support/plugin/translatepress-multilingual/';
/**
* New topic URL
*/
const NEW_TOPIC_URL = 'https://wordpress.org/support/plugin/translatepress-multilingual/#new-topic-0';
/**
* Transient key for caching forum posts
*/
const CACHE_KEY = 'trp_support_forum_posts';
/**
* Cache duration in seconds (1 hour)
*/
const CACHE_DURATION = HOUR_IN_SECONDS;
/**
* Number of posts to display
*/
const POSTS_COUNT = 5;
/**
* User meta key for last viewed timestamp
*/
const LAST_VIEWED_META_KEY = 'trp_support_chat_last_viewed';
/**
* Instance
*/
private static $instance = null;
/**
* Get instance
*/
public static function get_instance() {
if ( null === self::$instance ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Constructor
*/
private function __construct() {
// Only load for free version users in admin
$tp_product_name = TRP_Translate_Press::set_tp_product_name_static();
if ( ! array_key_exists( 'translatepress-multilingual', $tp_product_name ) ) {
return;
}
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
add_action( 'admin_footer', array( $this, 'render_chat_widget' ) );
add_action( 'wp_ajax_trp_get_forum_posts', array( $this, 'ajax_get_forum_posts' ) );
add_action( 'wp_ajax_trp_mark_forum_posts_read', array( $this, 'ajax_mark_forum_posts_read' ) );
}
/**
* Check if we should show the chat widget
*
* @return bool
*/
private function should_show_widget() {
if ( ! $this->is_translatepress_page() ) {
return false;
}
$screen = get_current_screen();
if ( $screen && $screen->id === 'admin_page_trp-onboarding' ) {
return false;
}
return true;
}
/**
* Check if current page is a TranslatePress admin page
*
* @return bool
*/
private function is_translatepress_page() {
if ( ! is_admin() ) {
return false;
}
$screen = get_current_screen();
if ( ! $screen ) {
return false;
}
// Check for TranslatePress pages
$trp_pages = array(
'settings_page_translate-press',
'admin_page_trp_license_key',
'admin_page_trp_addons_page',
'admin_page_trp_advanced_page',
'admin_page_trp_machine_translation',
'admin_page_trp_test_machine_api',
'admin_page_trp_optin_page',
'admin_page_trp_update_database',
'admin_page_trp_language_switcher',
'admin_page_trp-onboarding',
'admin_page_trp_error_manager',
);
foreach ( $trp_pages as $page ) {
if ( $screen->id === $page ) {
return true;
}
}
return false;
}
/**
* Enqueue assets
*/
public function enqueue_assets() {
if ( ! $this->should_show_widget() ) {
return;
}
wp_enqueue_style(
'trp-support-chat',
TRP_PLUGIN_URL . 'assets/css/trp-support-chat.css',
array(),
TRP_PLUGIN_VERSION
);
wp_enqueue_script(
'trp-support-chat',
TRP_PLUGIN_URL . 'assets/js/trp-support-chat.js',
array(),
TRP_PLUGIN_VERSION,
true
);
// Compute new post count from cached data, fetching if needed on first visit
$new_count = 0;
$last_viewed = (int) get_user_meta( get_current_user_id(), self::LAST_VIEWED_META_KEY, true );
$cached_posts = get_transient( self::CACHE_KEY );
if ( false === $cached_posts ) {
$cached_posts = $this->get_forum_posts();
}
if ( is_array( $cached_posts ) ) {
foreach ( $cached_posts as $post ) {
if ( ! empty( $post['timestamp'] ) && $post['timestamp'] > $last_viewed ) {
$new_count++;
}
}
}
wp_localize_script( 'trp-support-chat', 'trpSupportChat', array(
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'nonce' => wp_create_nonce( 'trp_support_chat' ),
'forumUrl' => self::FORUM_URL,
'newTopicUrl' => self::NEW_TOPIC_URL,
'newCount' => $new_count,
'lastViewed' => $last_viewed,
'strings' => array(
'title' => __( 'Need Help?', 'translatepress-multilingual' ),
'subtitle' => __( 'Recent community discussions', 'translatepress-multilingual' ),
'loading' => __( 'Loading...', 'translatepress-multilingual' ),
'error' => __( 'Unable to load forum posts', 'translatepress-multilingual' ),
'askQuestion' => __( 'Ask a Question', 'translatepress-multilingual' ),
'viewAll' => __( 'View All Topics', 'translatepress-multilingual' ),
'postedBy' => __( 'by', 'translatepress-multilingual' ),
'encourageTitle' => __( 'Have a question?', 'translatepress-multilingual' ),
'encourageText' => __( 'Get help directly from the plugin developers, suggest improvements, or share your feedback!', 'translatepress-multilingual' ),
'tipTitle' => __( 'Tip for faster help:', 'translatepress-multilingual' ),
'tipText' => __( 'Include what you tried, what you expected, and what happened. Screenshots help!', 'translatepress-multilingual' ),
),
) );
}
/**
* Render chat widget HTML
*/
public function render_chat_widget() {
if ( ! $this->should_show_widget() ) {
return;
}
?>
<div id="trp-support-chat-widget" class="trp-support-chat" style="display: none;">
<!-- Chat Toggle Button - Bar style -->
<button type="button" class="trp-support-chat__toggle" aria-label="<?php esc_attr_e( 'Toggle support chat', 'translatepress-multilingual' ); ?>">
<span class="trp-support-chat__toggle-content">
<span class="trp-support-chat__toggle-icon trp-support-chat__toggle-icon--chat">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="currentColor">
<path d="M12 2C6.48 2 2 6.04 2 11c0 2.21.89 4.22 2.34 5.75L2 22l5.25-2.34C8.78 20.53 10.35 21 12 21c5.52 0 10-4.04 10-9s-4.48-9-10-9zm0 16c-1.34 0-2.62-.29-3.78-.82l-.37-.18-2.49 1.11.98-2.58-.28-.4C4.74 13.98 4 12.55 4 11c0-3.87 3.59-7 8-7s8 3.13 8 7-3.59 7-8 7z"/>
<circle cx="8" cy="11" r="1.5"/>
<circle cx="12" cy="11" r="1.5"/>
<circle cx="16" cy="11" r="1.5"/>
</svg>
</span>
<span class="trp-support-chat__toggle-icon trp-support-chat__toggle-icon--close">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="currentColor">
<path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>
</svg>
</span>
<span class="trp-support-chat__toggle-text">
<?php esc_html_e( 'Need Help?', 'translatepress-multilingual' ); ?>
<span class="trp-support-chat__toggle-subtext"><?php esc_html_e( 'Ask the community', 'translatepress-multilingual' ); ?></span>
</span>
</span>
<span class="trp-support-chat__badge"></span>
</button>
<!-- Chat Window -->
<div class="trp-support-chat__window">
<!-- Header -->
<div class="trp-support-chat__header">
<div class="trp-support-chat__header-content">
<div class="trp-support-chat__avatar">
<img src="<?php echo esc_url( TRP_PLUGIN_URL . 'assets/images/tp-logo-square-light.svg' ); ?>" alt="TranslatePress" width="32" height="32">
</div>
<div class="trp-support-chat__header-text">
<h4 class="trp-support-chat__title"></h4>
<p class="trp-support-chat__subtitle"></p>
</div>
</div>
<button type="button" class="trp-support-chat__close" aria-label="<?php esc_attr_e( 'Close', 'translatepress-multilingual' ); ?>">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="20" height="20" fill="currentColor">
<path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>
</svg>
</button>
</div>
<!-- Body -->
<div class="trp-support-chat__body">
<!-- Encourage section - at top -->
<div class="trp-support-chat__encourage">
<div class="trp-support-chat__encourage-card">
<h5 class="trp-support-chat__encourage-title"></h5>
<p class="trp-support-chat__encourage-text"></p>
</div>
<div class="trp-support-chat__tip">
<strong class="trp-support-chat__tip-title"></strong>
<p class="trp-support-chat__tip-text"></p>
</div>
</div>
<!-- Recent discussions label -->
<div class="trp-support-chat__section-label"></div>
<!-- Loading state -->
<div class="trp-support-chat__loading">
<div class="trp-support-chat__spinner"></div>
<span></span>
</div>
<!-- Posts list -->
<div class="trp-support-chat__posts"></div>
</div>
<!-- Footer -->
<div class="trp-support-chat__footer">
<a href="<?php echo esc_url( self::NEW_TOPIC_URL ); ?>" target="_blank" rel="noopener" class="trp-support-chat__btn trp-support-chat__btn--primary">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="18" height="18" fill="currentColor">
<path d="M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z"/>
</svg>
<span></span>
</a>
<a href="<?php echo esc_url( self::FORUM_URL ); ?>" target="_blank" rel="noopener" class="trp-support-chat__btn trp-support-chat__btn--secondary">
<span></span>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="currentColor">
<path d="M10 6L8.59 7.41 13.17 12l-4.58 4.59L10 18l6-6z"/>
</svg>
</a>
</div>
</div>
</div>
<?php
}
/**
* AJAX handler to get forum posts
*/
public function ajax_get_forum_posts() {
check_ajax_referer( 'trp_support_chat', 'nonce' );
if ( ! current_user_can( 'manage_options' ) ) {
wp_send_json_error( array( 'message' => 'Unauthorized' ) );
}
$posts = $this->get_forum_posts();
if ( is_wp_error( $posts ) ) {
wp_send_json_error( array( 'message' => $posts->get_error_message() ) );
}
wp_send_json_success( array( 'posts' => $posts ) );
}
/**
* AJAX handler to mark forum posts as read
*/
public function ajax_mark_forum_posts_read() {
check_ajax_referer( 'trp_support_chat', 'nonce' );
if ( ! current_user_can( 'manage_options' ) ) {
wp_send_json_error( array( 'message' => 'Unauthorized' ) );
}
update_user_meta( get_current_user_id(), self::LAST_VIEWED_META_KEY, time() );
wp_send_json_success();
}
/**
* Get forum posts from RSS feed
*
* @return array|WP_Error
*/
private function get_forum_posts() {
// Try to get from cache
$cached = get_transient( self::CACHE_KEY );
if ( false !== $cached ) {
return $cached;
}
// Fetch RSS feed
$response = wp_remote_get( self::FEED_URL, array(
'timeout' => 4,
'sslverify' => true,
) );
if ( is_wp_error( $response ) ) {
set_transient( self::CACHE_KEY, array(), self::CACHE_DURATION );
return $response;
}
$body = wp_remote_retrieve_body( $response );
if ( empty( $body ) ) {
set_transient( self::CACHE_KEY, array(), self::CACHE_DURATION );
return new WP_Error( 'empty_feed', __( 'Empty feed response', 'translatepress-multilingual' ) );
}
// Parse XML
libxml_use_internal_errors( true );
$xml = simplexml_load_string( $body );
if ( false === $xml ) {
set_transient( self::CACHE_KEY, array(), self::CACHE_DURATION );
return new WP_Error( 'parse_error', __( 'Unable to parse feed', 'translatepress-multilingual' ) );
}
$posts = array();
$count = 0;
if ( isset( $xml->channel->item ) ) {
foreach ( $xml->channel->item as $item ) {
if ( $count >= self::POSTS_COUNT ) {
break;
}
// Get dc:creator namespace
$dc = $item->children( 'http://purl.org/dc/elements/1.1/' );
// Clean up title - strip HTML tags and decode entities
$title = (string) $item->title;
$title = strip_tags( $title );
$title = html_entity_decode( $title, ENT_QUOTES, 'UTF-8' );
$title = trim( $title );
$posts[] = array(
'title' => $title,
'link' => (string) $item->link,
'date' => $this->format_date( (string) $item->pubDate ),
'timestamp' => (int) strtotime( (string) $item->pubDate ),
'author' => isset( $dc->creator ) ? (string) $dc->creator : '',
);
$count++;
}
}
// Cache the results
set_transient( self::CACHE_KEY, $posts, self::CACHE_DURATION );
return $posts;
}
/**
* Format date for display
*
* @param string $date_string
* @return string
*/
private function format_date( $date_string ) {
$timestamp = strtotime( $date_string );
if ( ! $timestamp ) {
return '';
}
$now = time();
$diff = $now - $timestamp;
// Less than a day ago
if ( $diff < DAY_IN_SECONDS ) {
$hours = floor( $diff / HOUR_IN_SECONDS );
if ( $hours < 1 ) {
return __( 'Just now', 'translatepress-multilingual' );
}
/* translators: %d: number of hours */
return sprintf( _n( '%d hour ago', '%d hours ago', $hours, 'translatepress-multilingual' ), $hours );
}
// Less than a week ago
if ( $diff < WEEK_IN_SECONDS ) {
$days = floor( $diff / DAY_IN_SECONDS );
/* translators: %d: number of days */
return sprintf( _n( '%d day ago', '%d days ago', $days, 'translatepress-multilingual' ), $days );
}
// More than a week, show date
return date_i18n( get_option( 'date_format' ), $timestamp );
}
}
// Initialize
add_action( 'admin_init', array( 'TRP_Support_Chat', 'get_instance' ) );