Files
WooNooW/includes/Api/NotificationsController.php
dwindown 4471cd600f feat: Complete markdown syntax refinement and variable protection
 New cleaner syntax implemented:
- [card:type] instead of [card type='type']
- [button:style](url)Text[/button] instead of [button url='...' style='...']
- Standard markdown images: ![alt](url)

 Variable protection from markdown parsing:
- Variables with underscores (e.g., {order_items_table}) now protected
- HTML comment placeholders prevent italic/bold parsing
- All variables render correctly in preview

 Button rendering fixes:
- Buttons work in Visual mode inside cards
- Buttons work in Preview mode
- Button clicks prevented in visual editor
- Proper styling for solid and outline buttons

 Backward compatibility:
- Old syntax still supported
- No breaking changes

 Bug fixes:
- Fixed order_item_table → order_items_table naming
- Fixed button regex to match across newlines
- Added button/image parsing to parseMarkdownBasics
- Prevented button clicks on .button and .button-outline classes

📚 Documentation:
- NEW_MARKDOWN_SYNTAX.md - Complete user guide
- MARKDOWN_SYNTAX_AND_VARIABLES.md - Technical analysis
2025-11-15 20:05:50 +07:00

803 lines
22 KiB
PHP

<?php
/**
* Notifications REST API Controller
*
* Bridge to WooCommerce emails + addon channel framework.
*
* @package WooNooW\Api
*/
namespace WooNooW\Api;
use WP_REST_Controller;
use WP_REST_Server;
use WP_REST_Request;
use WP_REST_Response;
use WooNooW\Core\Notifications\TemplateProvider;
use WooNooW\Core\Notifications\EventRegistry;
use WooNooW\Core\Notifications\PushNotificationHandler;
class NotificationsController {
/**
* REST API namespace
*/
private $namespace = 'woonoow/v1';
/**
* REST API base
*/
private $rest_base = 'notifications';
/**
* Register routes
*/
public function register_routes() {
// GET /woonoow/v1/notifications/channels
register_rest_route($this->namespace, '/' . $this->rest_base . '/channels', [
[
'methods' => 'GET',
'callback' => [$this, 'get_channels'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/events
register_rest_route($this->namespace, '/' . $this->rest_base . '/events', [
[
'methods' => 'GET',
'callback' => [$this, 'get_events'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/notifications/events/update
register_rest_route($this->namespace, '/' . $this->rest_base . '/events/update', [
[
'methods' => 'POST',
'callback' => [$this, 'update_event'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/templates
register_rest_route($this->namespace, '/' . $this->rest_base . '/templates', [
[
'methods' => 'GET',
'callback' => [$this, 'get_templates'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET/PUT /woonoow/v1/notifications/templates/:eventId/:channelId
register_rest_route($this->namespace, '/' . $this->rest_base . '/templates/(?P<eventId>[a-zA-Z0-9_-]+)/(?P<channelId>[a-zA-Z0-9_-]+)', [
[
'methods' => 'GET',
'callback' => [$this, 'get_template'],
'permission_callback' => [$this, 'check_permission'],
],
[
'methods' => 'PUT',
'callback' => [$this, 'save_template'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/notifications/templates
register_rest_route($this->namespace, '/' . $this->rest_base . '/templates', [
[
'methods' => 'POST',
'callback' => [$this, 'save_template'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// DELETE /woonoow/v1/notifications/templates/:eventId/:channelId
register_rest_route($this->namespace, '/' . $this->rest_base . '/templates/(?P<eventId>[a-zA-Z0-9_-]+)/(?P<channelId>[a-zA-Z0-9_-]+)', [
[
'methods' => 'DELETE',
'callback' => [$this, 'delete_template'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/push/vapid-key
register_rest_route($this->namespace, '/' . $this->rest_base . '/push/vapid-key', [
[
'methods' => 'GET',
'callback' => [$this, 'get_vapid_key'],
'permission_callback' => '__return_true',
],
]);
// POST /woonoow/v1/notifications/push/subscribe
register_rest_route($this->namespace, '/' . $this->rest_base . '/push/subscribe', [
[
'methods' => 'POST',
'callback' => [$this, 'push_subscribe'],
'permission_callback' => '__return_true',
],
]);
// POST /woonoow/v1/notifications/push/unsubscribe
register_rest_route($this->namespace, '/' . $this->rest_base . '/push/unsubscribe', [
[
'methods' => 'POST',
'callback' => [$this, 'push_unsubscribe'],
'permission_callback' => '__return_true',
],
]);
// GET /woonoow/v1/notifications/email-settings
register_rest_route($this->namespace, '/' . $this->rest_base . '/email-settings', [
[
'methods' => 'GET',
'callback' => [$this, 'get_email_settings'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/notifications/email-settings
register_rest_route($this->namespace, '/' . $this->rest_base . '/email-settings', [
[
'methods' => 'POST',
'callback' => [$this, 'save_email_settings'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// DELETE /woonoow/v1/notifications/email-settings
register_rest_route($this->namespace, '/' . $this->rest_base . '/email-settings', [
[
'methods' => 'DELETE',
'callback' => [$this, 'reset_email_settings'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/push/settings
register_rest_route($this->namespace, '/' . $this->rest_base . '/push/settings', [
[
'methods' => 'GET',
'callback' => [$this, 'get_push_settings'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/notifications/push/settings
register_rest_route($this->namespace, '/' . $this->rest_base . '/push/settings', [
[
'methods' => 'POST',
'callback' => [$this, 'update_push_settings'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/notifications/channels/toggle
register_rest_route($this->namespace, '/' . $this->rest_base . '/channels/toggle', [
[
'methods' => 'POST',
'callback' => [$this, 'toggle_channel'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/staff/events
register_rest_route($this->namespace, '/' . $this->rest_base . '/staff/events', [
[
'methods' => 'GET',
'callback' => [$this, 'get_staff_events'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// GET /woonoow/v1/notifications/customer/events
register_rest_route($this->namespace, '/' . $this->rest_base . '/customer/events', [
[
'methods' => 'GET',
'callback' => [$this, 'get_customer_events'],
'permission_callback' => [$this, 'check_permission'],
],
]);
}
/**
* Get available notification channels
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_channels(WP_REST_Request $request) {
// Get channel enabled states
$email_enabled = get_option('woonoow_email_notifications_enabled', true);
$push_enabled = get_option('woonoow_push_notifications_enabled', true);
$channels = [
[
'id' => 'email',
'label' => __('Email', 'woonoow'),
'icon' => 'mail',
'enabled' => (bool) $email_enabled,
'builtin' => true,
],
[
'id' => 'push',
'label' => __('Push Notifications', 'woonoow'),
'icon' => 'bell',
'enabled' => (bool) $push_enabled,
'builtin' => true,
],
];
// Allow addons to register their channels
$channels = apply_filters('woonoow_notification_channels', $channels);
return new WP_REST_Response($channels, 200);
}
/**
* Get notification events
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_events(WP_REST_Request $request) {
$settings = get_option('woonoow_notification_settings', []);
// Get all events from EventRegistry (single source of truth)
$all_events = EventRegistry::get_all_events();
// Group by category and add settings
$grouped_events = [];
foreach ($all_events as $event) {
$category = $event['category'];
if (!isset($grouped_events[$category])) {
$grouped_events[$category] = [];
}
// Add channels from settings
$event_id = $event['id'];
$event['channels'] = $settings[$event_id]['channels'] ?? [
'email' => ['enabled' => false, 'recipient' => $event['recipient_type']],
'push' => ['enabled' => false, 'recipient' => $event['recipient_type']]
];
$event['recipients'] = [$event['recipient_type']];
$grouped_events[$category][] = $event;
}
return new WP_REST_Response($grouped_events, 200);
}
/**
* Get staff notification events (admin/staff recipient)
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_staff_events(WP_REST_Request $request) {
$all_events = $this->get_all_events();
// Filter events where recipient_type is 'staff'
$staff_events = [];
foreach ($all_events as $category => $events) {
$filtered = array_filter($events, function($event) {
return ($event['recipient_type'] ?? 'staff') === 'staff';
});
if (!empty($filtered)) {
$staff_events[$category] = array_values($filtered);
}
}
return new WP_REST_Response($staff_events, 200);
}
/**
* Get customer notification events (customer recipient)
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_customer_events(WP_REST_Request $request) {
$all_events = $this->get_all_events();
// Filter events where recipient_type is 'customer'
$customer_events = [];
foreach ($all_events as $category => $events) {
$filtered = array_filter($events, function($event) {
return ($event['recipient_type'] ?? 'staff') === 'customer';
});
if (!empty($filtered)) {
$customer_events[$category] = array_values($filtered);
}
}
return new WP_REST_Response($customer_events, 200);
}
/**
* Get all events (internal helper)
*
* @return array
*/
private function get_all_events() {
// Use EventRegistry - same as get_events() but returns ungrouped
$settings = get_option('woonoow_notification_settings', []);
// Get all events from EventRegistry (single source of truth)
$all_events = EventRegistry::get_all_events();
// Group by category and add settings
$grouped_events = [];
foreach ($all_events as $event) {
$category = $event['category'];
if (!isset($grouped_events[$category])) {
$grouped_events[$category] = [];
}
// Add channels from settings
$event_id = $event['id'];
$event['channels'] = $settings[$event_id]['channels'] ?? [
'email' => ['enabled' => false, 'recipient' => $event['recipient_type']],
'push' => ['enabled' => false, 'recipient' => $event['recipient_type']]
];
$grouped_events[$category][] = $event;
}
return $grouped_events;
}
/**
* Update event settings
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response|WP_Error
*/
public function update_event(WP_REST_Request $request) {
$params = $request->get_json_params();
$event_id = isset($params['eventId']) ? $params['eventId'] : null;
$channel_id = isset($params['channelId']) ? $params['channelId'] : null;
$enabled = isset($params['enabled']) ? $params['enabled'] : null;
$recipient = isset($params['recipient']) ? $params['recipient'] : null;
if (empty($event_id) || empty($channel_id)) {
return new WP_Error(
'invalid_params',
__('Event ID and Channel ID are required', 'woonoow'),
['status' => 400]
);
}
// Get current settings
$settings = get_option('woonoow_notification_settings', []);
// Update settings
if (!isset($settings[$event_id])) {
$settings[$event_id] = ['channels' => []];
}
if (!isset($settings[$event_id]['channels'])) {
$settings[$event_id]['channels'] = [];
}
$settings[$event_id]['channels'][$channel_id] = [
'enabled' => (bool) $enabled,
'recipient' => $recipient ?? 'admin',
];
// Save settings
update_option('woonoow_notification_settings', $settings, false);
// Fire action for addons to react
do_action('woonoow_notification_event_updated', $event_id, $channel_id, $enabled, $recipient);
return new WP_REST_Response([
'success' => true,
'message' => __('Event settings updated successfully', 'woonoow'),
], 200);
}
/**
* Check if user has permission
*
* @return bool
*/
public function check_permission() {
return current_user_can('manage_woocommerce') || current_user_can('manage_options');
}
/**
* Get all templates
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_templates(WP_REST_Request $request) {
$templates = TemplateProvider::get_templates();
return new WP_REST_Response($templates, 200);
}
/**
* Get single template
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response|WP_Error
*/
public function get_template(WP_REST_Request $request) {
$event_id = $request->get_param('eventId');
$channel_id = $request->get_param('channelId');
$recipient_type = $request->get_param('recipient') ?? 'customer';
$template = TemplateProvider::get_template($event_id, $channel_id, $recipient_type);
if (!$template) {
return new WP_Error(
'template_not_found',
__('Template not found', 'woonoow'),
['status' => 404]
);
}
// Add event and channel labels for UI
// Get events from controller method
$events_response = $this->get_events(new WP_REST_Request());
$events_data = $events_response->get_data();
// Get channels from controller method
$channels_response = $this->get_channels(new WP_REST_Request());
$channels_data = $channels_response->get_data();
// Find event label
foreach ($events_data as $category => $event_list) {
foreach ($event_list as $event) {
if ($event['id'] === $event_id) {
$template['event_label'] = $event['label'];
break 2;
}
}
}
// Find channel label
foreach ($channels_data as $channel) {
if ($channel['id'] === $channel_id) {
$template['channel_label'] = $channel['label'];
break;
}
}
return new WP_REST_Response($template, 200);
}
/**
* Save template
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response|WP_Error
*/
public function save_template(WP_REST_Request $request) {
$event_id = $request->get_param('eventId');
$channel_id = $request->get_param('channelId');
$recipient_type = $request->get_param('recipient') ?? 'customer';
$subject = $request->get_param('subject');
$body = $request->get_param('body');
$variables = $request->get_param('variables');
$template = [
'subject' => $subject,
'body' => $body,
'variables' => $variables,
];
$result = TemplateProvider::save_template($event_id, $channel_id, $template, $recipient_type);
if (!$result) {
return new WP_Error(
'save_failed',
__('Failed to save template', 'woonoow'),
['status' => 500]
);
}
return new WP_REST_Response([
'success' => true,
'message' => __('Template saved successfully', 'woonoow'),
], 200);
}
/**
* Delete template (revert to default)
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function delete_template(WP_REST_Request $request) {
$event_id = $request->get_param('eventId');
$channel_id = $request->get_param('channelId');
$recipient_type = $request->get_param('recipient') ?? 'customer';
TemplateProvider::delete_template($event_id, $channel_id, $recipient_type);
return new WP_REST_Response([
'success' => true,
'message' => __('Template reverted to default', 'woonoow'),
], 200);
}
/**
* Get VAPID public key for push notifications
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_vapid_key(WP_REST_Request $request) {
$public_key = PushNotificationHandler::get_public_key();
return new WP_REST_Response([
'publicKey' => $public_key,
], 200);
}
/**
* Subscribe to push notifications
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response|WP_Error
*/
public function push_subscribe(WP_REST_Request $request) {
$subscription = $request->get_param('subscription');
$user_id = get_current_user_id();
if (empty($subscription)) {
return new WP_Error(
'invalid_subscription',
__('Subscription data is required', 'woonoow'),
['status' => 400]
);
}
$success = PushNotificationHandler::subscribe($subscription, $user_id);
if (!$success) {
return new WP_Error(
'subscribe_failed',
__('Failed to subscribe to push notifications', 'woonoow'),
['status' => 500]
);
}
return new WP_REST_Response([
'success' => true,
'message' => __('Subscribed to push notifications', 'woonoow'),
], 200);
}
/**
* Unsubscribe from push notifications
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function push_unsubscribe(WP_REST_Request $request) {
$subscription_id = $request->get_param('subscriptionId');
PushNotificationHandler::unsubscribe($subscription_id);
return new WP_REST_Response([
'success' => true,
'message' => __('Unsubscribed from push notifications', 'woonoow'),
], 200);
}
/**
* Get push notification settings
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function get_push_settings(WP_REST_Request $request) {
$settings = PushNotificationHandler::get_settings();
return new WP_REST_Response($settings, 200);
}
/**
* Update push notification settings
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function update_push_settings(WP_REST_Request $request) {
$settings = $request->get_json_params();
if (empty($settings)) {
return new WP_Error(
'invalid_settings',
__('Settings data is required', 'woonoow'),
['status' => 400]
);
}
$success = PushNotificationHandler::update_settings($settings);
if (!$success) {
return new WP_Error(
'update_failed',
__('Failed to update push notification settings', 'woonoow'),
['status' => 500]
);
}
return new WP_REST_Response([
'success' => true,
'message' => __('Push notification settings updated', 'woonoow'),
'settings' => PushNotificationHandler::get_settings(),
], 200);
}
/**
* Toggle notification channel
*
* @param WP_REST_Request $request Request object
* @return WP_REST_Response
*/
public function toggle_channel(WP_REST_Request $request) {
$params = $request->get_json_params();
$channel_id = isset($params['channelId']) ? $params['channelId'] : null;
$enabled = isset($params['enabled']) ? $params['enabled'] : null;
if (empty($channel_id)) {
return new WP_Error(
'invalid_channel',
__('Channel ID is required', 'woonoow'),
['status' => 400]
);
}
if ($enabled === null) {
return new WP_Error(
'invalid_enabled',
__('Enabled parameter is required', 'woonoow'),
['status' => 400]
);
}
// Only allow toggling built-in channels
$option_key = '';
if ($channel_id === 'email') {
$option_key = 'woonoow_email_notifications_enabled';
} elseif ($channel_id === 'push') {
$option_key = 'woonoow_push_notifications_enabled';
} else {
return new WP_Error(
'invalid_channel',
__('Invalid channel ID', 'woonoow'),
['status' => 400]
);
}
// Update the option
update_option($option_key, (bool) $enabled, false); // false = don't autoload
// Verify the update
$verified = get_option($option_key);
return new WP_REST_Response([
'success' => true,
'message' => sprintf(
__('%s notifications %s', 'woonoow'),
$channel_id === 'email' ? __('Email', 'woonoow') : __('Push', 'woonoow'),
$enabled ? __('enabled', 'woonoow') : __('disabled', 'woonoow')
),
'channelId' => $channel_id,
'enabled' => (bool) $verified,
], 200);
}
/**
* Get email customization settings
*/
public function get_email_settings(WP_REST_Request $request) {
$defaults = [
'primary_color' => '#7f54b3',
'secondary_color' => '#7f54b3',
'hero_gradient_start' => '#667eea',
'hero_gradient_end' => '#764ba2',
'hero_text_color' => '#ffffff',
'button_text_color' => '#ffffff',
'body_bg_color' => '#f8f8f8',
'social_icon_color' => 'white',
'logo_url' => '',
'header_text' => '',
'footer_text' => '',
'social_links' => [],
];
$settings = get_option('woonoow_email_settings', $defaults);
// Ensure social_links is an array
if (!isset($settings['social_links']) || !is_array($settings['social_links'])) {
$settings['social_links'] = [];
}
// Merge with defaults to ensure all fields exist
$settings = array_merge($defaults, $settings);
return new WP_REST_Response($settings, 200);
}
/**
* Save email customization settings
*/
public function save_email_settings(WP_REST_Request $request) {
$data = $request->get_json_params();
$settings = [
'primary_color' => sanitize_hex_color($data['primary_color'] ?? '#7f54b3'),
'secondary_color' => sanitize_hex_color($data['secondary_color'] ?? '#7f54b3'),
'hero_gradient_start' => sanitize_hex_color($data['hero_gradient_start'] ?? '#667eea'),
'hero_gradient_end' => sanitize_hex_color($data['hero_gradient_end'] ?? '#764ba2'),
'hero_text_color' => sanitize_hex_color($data['hero_text_color'] ?? '#ffffff'),
'button_text_color' => sanitize_hex_color($data['button_text_color'] ?? '#ffffff'),
'body_bg_color' => sanitize_hex_color($data['body_bg_color'] ?? '#f8f8f8'),
'social_icon_color' => in_array($data['social_icon_color'] ?? 'white', ['white', 'black']) ? $data['social_icon_color'] : 'white',
'logo_url' => esc_url_raw($data['logo_url'] ?? ''),
'header_text' => sanitize_text_field($data['header_text'] ?? ''),
'footer_text' => sanitize_text_field($data['footer_text'] ?? ''),
'social_links' => $this->sanitize_social_links($data['social_links'] ?? []),
];
update_option('woonoow_email_settings', $settings);
return new WP_REST_Response([
'success' => true,
'message' => __('Email settings saved successfully', 'woonoow'),
'settings' => $settings,
], 200);
}
/**
* Reset email customization settings to defaults
*/
public function reset_email_settings(WP_REST_Request $request) {
delete_option('woonoow_email_settings');
return new WP_REST_Response([
'success' => true,
'message' => __('Email settings reset to defaults', 'woonoow'),
], 200);
}
/**
* Sanitize social links array
*/
private function sanitize_social_links($links) {
if (!is_array($links)) {
return [];
}
$sanitized = [];
$allowed_platforms = ['facebook', 'x', 'instagram', 'linkedin', 'youtube', 'discord', 'spotify', 'telegram', 'whatsapp', 'threads', 'website'];
foreach ($links as $link) {
if (!is_array($link) || !isset($link['platform']) || !isset($link['url'])) {
continue;
}
$platform = sanitize_text_field($link['platform']);
$url = esc_url_raw($link['url']);
if (in_array($platform, $allowed_platforms) && !empty($url)) {
$sanitized[] = [
'platform' => $platform,
'url' => $url,
];
}
}
return $sanitized;
}
}