Frequently Asked Questions

Find quick answers to common questions about NexlifyDesk. Can’t
find what you’re looking for? Contact our support team.

Quick Navigation

🚀

Setup & Installation

How do I install NexlifyDesk?

+

Method 1: WordPress Admin (Recommended)

  1. Download the NexlifyDesk plugin ZIP file
  2. Go to your WordPress admin → Plugins → Add New
  3. Click "Upload Plugin" and select the ZIP file
  4. Click "Install Now" then "Activate Plugin"

Method 2: FTP Upload

  1. Extract the ZIP file to get the 'nexlifydesk' folder
  2. Upload the folder to '/wp-content/plugins/' via FTP
  3. Go to WordPress admin → Plugins and activate NexlifyDesk
💡 Pro Tip: After activation, you'll see "NexlifyDesk" in your admin menu. Start with the Settings page to configure basic options.

What are the minimum system requirements?

+
  • WordPress: Version 6.2 or higher
  • PHP: Version 7.4 or higher (PHP 8.0+ recommended)
  • Database: MySQL 5.7+ or MariaDB 10.2+
  • Web Server: Apache or Nginx
  • SSL Certificate: Required for email piping features
⚠️ Important: Email piping with AWS WorkMail requires SSL (HTTPS) to be enabled on your website.

How do I set up the frontend pages for customers?

+

Step 1: Create Ticket Submission Page

  1. Go to Pages → Add New in your WordPress admin
  2. Title the page "Submit Ticket" or "Contact Support"
  3. Add the shortcode:
  4. Publish the page

Step 2: Create Ticket History Page

  1. Create another new page
  2. Title it "My Tickets" or "Support History"
  3. Add the shortcode:

    Your Support Tickets

    View and track your support requests

    Submit New Ticket
    📄

    No tickets found

    You haven't submitted any support tickets yet.

    Submit Your First Ticket
  4. Publish the page

Step 3: Configure Page Links (Optional)

Go to NexlifyDesk → Settings and set these page URLs for proper navigation between forms.

Shortcode Options:
- Hide default title

Your Support Tickets

View and track your support requests

Submit New Ticket
📄

No tickets found

You haven't submitted any support tickets yet.

Submit Your First Ticket
- Show only 10 recent tickets

Features & Usage

How do I set up support agents and assign permissions?

+

Basic Agent Setup:

  1. Go to Users → Add New
  2. Create user accounts for your support team
  3. Assign them the "NexlifyDesk Agent" role
  4. They'll now have access to the ticket management system

Advanced Agent Positions:

  1. Go to NexlifyDesk → Agent Positions
  2. Create custom positions (e.g., "Level 1 Support", "Technical Lead")
  3. Define capabilities for each position:
    • View All Tickets: See organization-wide tickets vs. only assigned ones
    • Assign Tickets: Assign tickets to other agents
    • Manage Categories: Create and organize ticket categories
    • View Reports: Access analytics and performance data
  4. Assign agents to positions via their user profiles
💡 Auto-Assignment: Enable auto-assignment in Settings to automatically distribute new tickets to available agents based on workload.

How does the duplicate ticket detection work?

+

NexlifyDesk uses a sophisticated three-layer detection system:

🎯 1. Exact Subject Matching

Detects identical subjects from the same user within the last 30 days. New messages automatically become replies to the existing conversation.

📋 2. Order Number Recognition

Intelligently recognizes patterns like "Order #12345", "Invoice ID: 67890", "#ABC123" and links all order-related communications to a single ticket.

🧠 3. Content Similarity Analysis

Advanced keyword comparison with configurable similarity threshold (default: 80%). Smart filtering of common words for accurate matching.

Configuration Options:

  • Enable/disable detection in NexlifyDesk → Settings
  • Adjust sensitivity threshold to match your workflow
  • View detection statistics in the Reports dashboard
👥 User Experience: When a duplicate is detected, users receive clear notification that their message has been added to an existing conversation, maintaining context while preventing scattered tickets.

What are internal notes and how do I use them?

+

Internal notes are private messages between support team members that are completely invisible to customers.

Key Features:

  • Only visible to agents and administrators
  • Never sent to customers via email
  • Perfect for sharing context, escalation notes, or internal updates
  • Maintain complete conversation history for team reference

How to Add Internal Notes:

  1. Open any ticket in the admin area
  2. Scroll to the reply section
  3. Click the "Add Internal Note" tab
  4. Write your note and click "Add Note"
💼 Common Use Cases:
  • Escalation notes when transferring tickets
  • Technical details for other team members
  • Customer background information
  • Resolution attempts and outcomes

How do I configure file uploads and what types are supported?

+

Default Supported File Types:

JPG PNG PDF DOC DOCX TXT

Configuration Options:

  1. Go to NexlifyDesk → Settings
  2. Find the "File Attachments" section
  3. Customize:
    • Allowed Extensions: Add/remove file types
    • Maximum File Size: Set size limits per attachment
    • Maximum Files: Limit number of files per ticket
🔒 Security Features:
  • All uploads are validated and virus-scanned
  • Files stored in secure, non-web-accessible directory
  • Access controlled through WordPress permissions
  • Automatic cleanup of orphaned files
🔗

Integration & Email Setup

How do I set up email piping to convert emails into tickets?

+

Email piping automatically converts incoming emails into support tickets. Setup varies by email provider:

⚠️ Important: Test your email piping setup with a few test emails before going live. Check the logs in NexlifyDesk → Settings for any connection issues.

How does WooCommerce integration work?

+

NexlifyDesk automatically integrates with WooCommerce to provide better customer support context:

📋 Order History Access

Agents can search for customer orders directly from the admin interface using order numbers, customer emails, or names.

👤 Customer Context

When viewing a ticket, agents can see relevant order information including purchase date, items ordered, and order status.

🔗 Order-based Duplicate Detection

Tickets mentioning the same order number are automatically linked together, preventing scattered conversations about the same purchase.

Accessing Order Information:

  1. Go to NexlifyDesk → Order History
  2. Search by order number, customer name, or email
  3. View complete order details and history
  4. Link directly to related support tickets
💡 Pro Tip: The integration is automatic - no configuration needed. Just install both plugins and they'll work together seamlessly.
🎨

Customization & Appearance

How do I customize email notification templates?

+

Access Email Templates:

  1. Go to NexlifyDesk → Email Templates
  2. Choose from available templates:
    • New Ticket: Sent when customers create tickets
    • New Reply: Sent when agents or customers reply
    • Status Changed: Sent when ticket status updates
    • SLA Breach: Sent when response times exceed targets
  3. Edit content using the visual editor
  4. Use dynamic placeholders for personalization

🏷️ Available Placeholders

{ticket_id} {subject} {user_name} {user_email} {status} {priority} {category} {agent_name} {ticket_url} {site_name} {date_created} {last_reply}
📧 Example Template:
Hello {user_name},

Your ticket #{ticket_id} regarding "{subject}" has been updated.
New Status: {status}

View your ticket: {ticket_url}

Best regards,
{site_name} Support Team

Can I customize the appearance and styling?

+

Customization Methods:

🎨 CSS Styling Override

Add custom CSS to your theme's style.css or through the WordPress Customizer:

/* Customize ticket form */ .nexlifydesk-form { background: #f9f9f9; border-radius: 10px; padding: 20px; } /* Style submit buttons */ .nexlifydesk-form .submit-button { background: #your-brand-color; border: none; padding: 12px 30px; }

📁 Template System

For advanced customization, copy plugin templates to your theme:

  1. Create folder: /your-theme/nexlifydesk/
  2. Copy template files from plugin's /templates/ folder
  3. Modify the copied files to match your design
  4. Changes will be preserved during plugin updates

⚙️ Settings Panel

Use built-in options in NexlifyDesk → Settings:

  • Custom colors and branding
  • Label text changes
  • Form field configurations
  • Behavior customizations
💡 Development Tip: Use browser developer tools to inspect elements and identify CSS classes for targeting specific components.
🔧

Troubleshooting & Support

Email notifications are not being sent. How do I fix this?

+

Common Causes & Solutions:

1. 📧 Check WordPress Email Configuration

NexlifyDesk uses WordPress's built-in mail system. Test if your site can send emails:

  • Try WordPress password reset (forgot password link)
  • If that fails, your server's email isn't configured properly
  • Contact your hosting provider or install an SMTP plugin

2. ⚙️ Verify Notification Settings

  1. Go to NexlifyDesk → Settings
  2. Check "Email Notifications" section
  3. Ensure notifications are enabled for the events you want
  4. Verify email addresses are correct

3. 📄 Check Email Templates

  1. Go to NexlifyDesk → Email Templates
  2. Ensure templates aren't blank or corrupted
  3. Reset to defaults if needed

4. 🗂️ Check Spam Folders

Emails might be going to spam. Check spam/junk folders and add your site's email to safe sender lists.

The plugin is not working after activation. What should I check?

+

Step-by-Step Troubleshooting:

✅ 1. Verify System Requirements

  • WordPress 6.2 or higher
  • PHP 7.4 or higher
  • Sufficient memory limit (256MB recommended)

✅ 2. Check Plugin Conflicts

  • Deactivate all other plugins temporarily
  • Test if NexlifyDesk works
  • Reactivate plugins one by one to identify conflicts

✅ 3. Switch to Default Theme

  • Temporarily switch to a default WordPress theme
  • Test NexlifyDesk functionality
  • If it works, there's a theme conflict

✅ 4. Check Error Logs

  • Enable WordPress debug logging
  • Check /wp-content/debug.log for errors
  • Contact support with specific error messages
🔍 Enable Debug Mode:

Add to your wp-config.php:

define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);

What happens to my data if I uninstall the plugin?

+

🛡️ Default: Data is Preserved

By default, NexlifyDesk keeps all your valuable support data when uninstalled:

  • All tickets and customer conversations
  • Agent responses and internal notes
  • File attachments and customer data
  • Categories and configuration settings
  • Performance analytics and reports

🗑️ Optional: Complete Data Removal

To permanently delete all plugin data during uninstall:

  1. Go to NexlifyDesk → Settings
  2. Find "Data Management" section
  3. Uncheck "Keep all tickets and data when plugin is uninstalled"
  4. Save settings before uninstalling
⚠️ Critical Warning: Complete removal permanently deletes ALL support history, customer data, and configurations. This action cannot be undone. Always backup your database before proceeding.
💾 Backup Recommendation: Before making any major changes, create a full database backup using your hosting control panel or a backup plugin.

Still Need Help?

Can't find the answer you're looking for? Our support team is here to help you get the most out of NexlifyDesk.

📧

Email Support

Get detailed help from our technical team

Contact Support
📚

Documentation

Comprehensive guides and tutorials

View Docs
💬

Community

Connect with other users and get help

Visit Forum