NexlifyDesk Documentation

Empowering WordPress Users to Take Control of Their Websites

Shortcodes & Integration

NexlifyDesk provides two main shortcodes to seamlessly integrate the ticketing system into your website's frontend pages. These shortcodes are flexible and can be customized with attributes to match your specific needs.

🎯 Quick Integration

With just two shortcodes, you can add a complete support system to any page on your WordPress site. Perfect for contact pages, customer portals, or dedicated support sections.

Ticket Form Shortcode

Shortcode:
Shortcode: [nexlifydesk_ticket_form]
This shortcode displays the ticket submission form for customers.

This shortcode displays the ticket submission form for customers.

This shortcode displays the complete ticket submission form, allowing customers to create new support requests.

Basic Usage

Shortcode:
Shortcode: [nexlifydesk_ticket_form]
This shortcode displays the ticket submission form for customers.

This shortcode displays the ticket submission form for customers.

This will display a complete ticket submission form with default settings.

Available Attributes

show_title

Default: "yes"

Options: "yes", "no"

Controls whether to display the default "Submit a Ticket" title above the form.

category

Default: None

Options: Category ID number

Pre-selects a specific ticket category by its numerical ID.

priority

Default: "medium"

Options: "low", "medium", "high"

Sets the default priority level for new tickets submitted through this form.

Advanced Examples

Hide Title with Pre-selected Category
Shortcode:
Shortcode: [nexlifydesk_ticket_form]
This shortcode displays the ticket submission form for customers.

This shortcode displays the ticket submission form for customers.

Perfect for embedding in a custom-designed contact page where you provide your own heading.

High Priority Support Form
Shortcode:
Shortcode: [nexlifydesk_ticket_form]
This shortcode displays the ticket submission form for customers.

This shortcode displays the ticket submission form for customers.

Ideal for VIP customer pages or urgent support sections.

Clean Minimal Form
Shortcode:
Shortcode: [nexlifydesk_ticket_form]
This shortcode displays the ticket submission form for customers.

This shortcode displays the ticket submission form for customers.

Great for FAQ pages or general inquiry forms.

Ticket List Shortcode

Shortcode:
Shortcode: [nexlifydesk_ticket_list]
This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays a list of tickets submitted by the currently logged-in user, allowing them to track their history and status.

Basic Usage

Shortcode:
Shortcode: [nexlifydesk_ticket_list]
This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays the user's ticket history and allows them to view their support tickets.

This will display all tickets for the current user with default pagination.

Available Attributes

show_title

Default: "yes"

Options: "yes", "no"

Controls whether to display the default "Ticket List" title.

status

Default: All statuses

Options: "open", "in-progress", "pending", "resolved", "closed"

Filters the list to show only tickets with a specific status.

limit

Default: "10"

Options: Any number

Limits the number of tickets displayed per page.

Advanced Examples

Show Only Open Tickets
Shortcode:
Shortcode: [nexlifydesk_ticket_list]
This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays the user's ticket history and allows them to view their support tickets.

Perfect for a "Current Issues" page where customers can see active tickets.

Compact Recent Tickets
Shortcode:
Shortcode: [nexlifydesk_ticket_list]
This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays the user's ticket history and allows them to view their support tickets.

Great for dashboard widgets showing recent support activity.

Resolved Tickets Archive
Shortcode:
Shortcode: [nexlifydesk_ticket_list]
This shortcode displays the user's ticket history and allows them to view their support tickets.

This shortcode displays the user's ticket history and allows them to view their support tickets.

Useful for a "Solved Issues" page for reference.

Ticket Statuses

NexlifyDesk uses five distinct statuses to manage the ticket lifecycle effectively. These statuses help track a ticket's progress from submission to resolution.

🆕

Open

The initial status for all new tickets awaiting a response from a support agent.

🔧

In Progress

Indicates that a ticket has been assigned to an agent and is being actively worked on.

Pending

Used when the agent is awaiting a reply from the customer or action from a third party.

Resolved

The issue has been solved by the agent, and the ticket is awaiting final confirmation or closure.

🔒

Closed

The ticket is considered complete and closed. A resolved ticket will auto-close after 48 hours of inactivity.

Agent Capabilities

When creating custom agent roles in NexlifyDesk > Agent Positions, you can assign a granular set of permissions to control what each agent can see and do within the helpdesk.

👁️

View All Tickets

Grants the ability to see all tickets across the entire helpdesk. If disabled, agents can only view tickets that are directly assigned to them.

👥

Assign Tickets

Allows an agent to assign or reassign tickets to other agents or departments. Essential for team leads and managers.

📁

Manage Categories

Permits an agent to create, edit, or delete ticket categories, helping to organize the support queue.

📊

View Reports

Provides access to the analytics and reporting dashboard, allowing the agent to view performance data and ticket trends.

Theme Customization

NexlifyDesk is designed to be highly customizable, allowing you to tailor its appearance and functionality to match your brand and workflow.

🎨 CSS Styling

Add your own custom CSS to your theme's stylesheet or the WordPress Customizer to override the default plugin styles.

.nexlifydesk-form { border-radius: 10px; }

📄 Template Override

For structural changes, copy the plugin's template files from the /templates/ folder into a /nexlifydesk/ folder within your theme's directory and modify them directly.

your-theme/
└── nexlifydesk/
    ├── frontend/
    │   ├── ticket-form.php
    │   └── ticket-list.php
    └── emails/
        └── new_ticket.php

⚙️ Settings Panel (Coming soon)

Adjust colors, labels, and behavior for certain elements directly within the plugin's settings panel.

Location: NexlifyDesk > Settings > Appearance

⚠️ Template Override Best Practices

When overriding templates, always make a backup and test thoroughly. Template overrides may need updates when the plugin is updated to maintain compatibility.

🚀 Ready to Implement?

Start with the basic shortcodes and gradually add customizations as needed. The flexible attribute system allows you to create exactly the support experience your customers need.

  1. Add
    Shortcode:
    Shortcode: [nexlifydesk_ticket_form]
    This shortcode displays the ticket submission form for customers.

    This shortcode displays the ticket submission form for customers.
    to your contact or support page
  2. Create a customer portal with
    Shortcode:
    Shortcode: [nexlifydesk_ticket_list]
    This shortcode displays the user's ticket history and allows them to view their support tickets.

    This shortcode displays the user's ticket history and allows them to view their support tickets.
  3. Customize appearance with CSS or template overrides
  4. Configure agent roles and permissions
  5. Test the complete customer journey