Welcome

## PixelDesk PHP Script Installation Process

This documentation file provides a comprehensive guide for installing and configuring PixelDesk, our support ticket system software. While the installation process is straightforward, certain instructions may assume a basic familiarity with database management and server file handling.

If you encounter difficulties or lack experience with any of the steps outlined here, don't hesitate to contact our support team for assistance.

Requirements

## Server/System Requirements

Before installing this script, ensure that your server meets the following requirements:

##### Requirements information

- PHP Version 7.3 or above
- MySQL Version 5.7+ or MariaDB version 10.2+
- Ctype PHP Extension
- Fileinfo PHP extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- PDO_MYSQL PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
- CURL PHP Extension
- GD PHP Extension
- Folder Permission 775/777

These requirements are essential to guarantee a smooth installation and optimal performance of the script. Make sure your server environment aligns with these specifications before proceeding with the installation process.

Installation Process

## Offline Installation Guide for PixelDesk

Follow these steps to successfully install your PixelDesk on your localhost PC:

##### Step 1: Extract ZIP and Place Files

1. Extract the main installation files from the downloaded archive.
2. Move the extracted files to your local server's `www` directory (for WAMP) or `htdocs` directory (for XAMPP).

##### Step 2: Create a Database

1. Open your web browser and navigate to phpMyAdmin.
2. Create a new database that will be used by application.

##### Step 3: Access the Installation Wizard

1. Launch your web browser.
2. Enter the following URL in the address bar: `http://localhost/myscript` (replace `myscript` with the appropriate folder name you used in Step 2).

##### Step 4: Installation Wizard

1. The installation wizard will load, checking if your server meets the requirements. Make sure your server meets all the requirements listed.
2. The wizard will also check for necessary file permissions. If any file or directory requires permissions changes, follow the instructions provided.
3. Proceed through the wizard by providing inputs like the application name and other necessary information.
4. Follow the steps in the installation wizard until you reach the final step.

##### Step 5: Finalize Installation

1. In the final step of the installation wizard, click the "Install" button.
2. The installation process will commence. Wait for the process to complete.

##### Step 6: Installation Success

1. Once the installation is successful, you will see a message confirming the installation.
2. The message will also provide you with default access credentials for logging in.

                                                            For Admin Default Aceess
                                                            Username: admin
                                                            Password: 123123

Please note that these steps are a general guideline. Depending on your local server configuration and any specific instructions provided with the script, there might be slight variations in the installation process. Always refer to the script's documentation or readme file for any additional information.

Update Process

## Software Update Guide for PixelDesk

To update your PixelDesk software, follow these steps:

##### Step 1: Click On System Upgrade

1. In this page you can see current version of usages and file upload form, Then just upload update file into it and click on Submit

##### Step 2: Clearing the Cache

1. Once you've successfully updated and received the confirmation message from the system, clear the cache.

1. If you are using CloudFlare then follow also this steps extra

Note: Please make sure to backup all your existing data before proceeding with the update. We are not responsible for any data loss.

Installation Process

## Installation Guide for PixelDesk on cPanel

Follow these steps to successfully install your PixelDesk on your cPanel hosting:

##### Step 1: Extract and Upload Files

1. Extract the main installation files from the downloaded archive.
2. Upload the extracted files to your cPanel hosting account. You can use an FTP client or cPanel's File Manager for this.

##### Step 2: Create a Database

1. Log in to your cPanel account.
2. Navigate to the MySQL Databases section and create a new database for your Laravel application.

##### Step 3: Configure Database

1. While still in cPanel, go to the MySQL Databases section and create a new database user.
2. Assign the user to the database you created and grant necessary privileges.

##### Step 4: Access the Installation Wizard

1. Launch your web browser.
2. Enter the following URL in the address bar: `http://yourdomain.com` or `http://yourdomain.com/myscript` (replace `myscript` with the appropriate folder name you used in Step 1).

##### Step 5: Installation Wizard

1. The installation wizard will load, checking if your server meets the requirements. Make sure your server meets all the requirements listed.
2. The wizard will also check for necessary file permissions. If any file or directory requires permissions changes, follow the instructions provided.
3. Proceed through the wizard by providing inputs like the application name and other necessary information.
4. Follow the steps in the installation wizard until you reach the final step.

##### Step 6: Finalize Installation

1. In the final step of the installation wizard, click the "Install" button.
2. The installation process will commence. Wait for the process to complete.

##### Step 7: Installation Success

1. Once the installation is successful, you will see a message confirming the installation.
2. The message will also provide you with default access credentials for logging in.

                                                            For Admin Default Aceess
                                                            Username: admin
                                                            Password: 123123

Please keep in mind that the steps provided are general guidelines. Depending on your hosting provider and any specific instructions from the script's documentation, the installation process might have variations. Always refer to the script's documentation or readme for any specific guidance.

Application Configuration

## Configuration of Pixel Desk.

Dive into Pixel Desk's "App Settings," where administrators shape the essence of the platform. From configuring ticket workflows to fine-tuning aesthetics and seamless integrations like Slack and reCAPTCHA, this hub empowers administrators to orchestrate a personalized, efficient, and secure support experience. Pixel Desk's App Settings—a canvas for customization, a toolkit for tailored excellence.

First Navigate To The App Settings Panel

- ##### Basic Settings

  Admin can manage: Site name - Site Contact Number - Site Email Address - The Address of the company - Copy Right Text - The amount of rows which are visible in each page where pagination is available. - Cookie Message

- ##### Agent Settings

  Admin can change the following to calculate the best agent, - Average Response time of an Agent - Minimum number of responded ticket number

- ##### Theme Settings

  A Admin can manage: The Primary Color - The Scondary Color - Text Primary Color - Text Secondary Color

- ##### Ticket Settings

  Here Admin has the controls over what a user will need to provide before submitting a ticket. Admin can update the following, - Add New fields for users to fill - Ticket Short Notes to guide users

- ##### Storage Settings

  Admin can change: The type of storage site will use - Supported File Types - Maximum number of uploaded files - Maximum size for uploaded files

- ##### Pusher Settings

  Admin can change: Pusher App Id - The App key - App Secret - App Cluster - Channel Name - Event Name

- ##### Slack Settings

  Admin can change: Webhook URL - Channel Name

- ##### Logo Settings

  Admin can change: Admin Panel Logo - Logo Icon - Frontend Logo - Site Fevicon
After Updating all these information click on the "submit" button to save the changes

Application Configuration

## Third Party Configure of PixelDesk.

PixelDesk app uses two third party authentication process for login security and you can also configure recaptcha

- ##### Recaptcha Settings

  Admin can change: Toggle to use default captcha - the Key - Secret Key - And the status if Re-captcha will be used or not

- ##### Recaptcha Settings

  Admin can change: Google Oauth Client ID - Client Secret for Google Oauth - Status if Google Oauth will be used or not - Callback URL for Google Oauth - Facebook Oauth client ID - Client Secret for Facebook Oauth - The status if a client can use Facebook login or not - Call back URL for facebook Oauth

CRON Job Setup

## Configure an automated cron job on cPanel for Pixel Desk.

A cron job for Pixel Desk is essential to ensure scheduled tasks and automated processes are executed at specific times or intervals. This helps maintain the efficiency and reliability of PixelDesk, ensuring that important functions, such as data synchronization or updates, occur without manual intervention.

Follow these steps to successfully implement cron jobs for PixelDesk on cPanel:

##### Step 1: Get Cron Job CURL Url

Access your web control panel, go to the 'Cron' section, and select the relevant option.

##### Step 2: CRON URL Set

1. Log in to your web control panel, navigate to the 'Cron' section, and then click on the appropriate option.
2. Please provide more context or specific information about what you'd like to revise, and I'll be happy to help you craft a revised sentence or instruction.

You are done!

AI Configuration

## OpenAI ChatGPT Integration

Elevate user interactions with Pixel Desk's seamless integration of OpenAI's ChatGPT. Empower your support ecosystem with intelligent responses, efficient query resolutions, and dynamic content generation. Harness the power of AI to enhance user experience, making each interaction a step towards unparalleled customer satisfaction.

- ##### AI Configuration

  Admin can change: Chat GPT Open AI API Key - Status
After Updating the information click on the "submit" button to save the changes.
AI Usages In PixelDesk

## PixelDesk's integration with AI, particularly with OpenAI, revolutionizes its support ticket system.

##### Here's how:

1. Faster User Replies: By integrating with OpenAI, PixelDesk can generate rapid responses to user queries. The AI analyzes incoming support tickets and provides instant, accurate suggestions or replies, significantly reducing response times.

2. Support Ticket Details: PixelDesk's AI integration assists in extracting critical information from support tickets. It can categorize, prioritize, and assign tickets based on context, urgency, and historical data, ensuring efficient handling of customer inquiries.

3. Article Description Creation: Leveraging AI, PixelDesk can autonomously create detailed article descriptions based on common support queries. It compiles information from various sources, crafting comprehensive and user-friendly guides for frequently encountered issues.

4. Instant Suggestions: Users receive immediate suggestions and troubleshooting steps as they compose their support queries. The AI suggests relevant articles, resolutions, or actions, empowering users to potentially resolve their issues independently.

5. Efficient and Accurate Recommendations: PixelDesk's integration eliminates the need for manual thinking and analysis. It provides accurate, context-aware suggestions without consuming additional time, streamlining the support process.

6. Continuous Improvement: Through machine learning, PixelDesk's AI continually learns from interactions, refining its responses and suggestions over time. This ongoing improvement enhances accuracy and ensures up-to-date support for users.

###### Ticket Reply

###### Article Create

###### Site Ready:: Content Make

Mail Gateway Setup

## Configure Mail Gateway of Pixel Desk.

Pixel Desk Mail Gateway provides integration options with leading providers like SMTP, PHP Mail, Send Grid support. This allows you to diversify your email delivery channels and optimize server performance.

##### Step 1: Navigate To The Mail Gateway Section

##### Step 2: Edit the gateway you want to use

##### Step 3: Choose and Setup Mail Gateway

1. Next, simply enter your chosen mail gateway's configuration access or credentials into the corresponding input fields.

In our case we have chosen SMTP

##### Step 4: Test The Gateway You Just Added

SMS Gateway Setup

## Configure SMS gateway of Pixel Desk.

Pixel Desk SMS Gateway provides integration options with leading providers like Nexmo, Twilio, InfoBip and others gateways. This allows you to diversify your SMS delivery channels and optimize server performance.

##### Step 1: Navigate To The SMS Gateway Section

##### Step 2: Edit the gateway you want to use

##### Step 3: Choose and Setup SMS Gateway

1. Next, simply enter your chosen sms gateway's configuration access or credentials into the corresponding input fields.

How To Use - Step 01

## Ticket Category

Effortlessly curate the support experience with Pixel Desk's Admin Panel. To create a ticket category, follow these simple steps:

1. Navigate: Select the "Ticket Setting" option from Menus and then select "Ticket Categories" to create a category for tickets.
2. Add New: Then Click on the "Add New" button and fill up the form to create a ticket category from admin panel.

How To Use - Step 02

## Ticket Priority Configuration

Tailor the urgency and importance of support requests with Pixel Desk's flexible Ticket Priority settings. Follow these straightforward steps within the Admin Panel:

1. Navigate: Select the "Ticket Setting" option from Menus and then select "Ticket Priority" to add a priority for tickets.
2. Add New: Then Click on "Add New" button to get a form.
3. Submit: Then fill up the form with the appropriate data and after filling up the entire form click "Add".

How To Use - Step 03

## Adding Agents

Empower your support team by seamlessly adding Agents through Pixel Desk's intuitive Admin Panel. Follow these steps to enhance your support capabilities:

1. Navigate: Select the "Agent Management" option from Menus and then select "Add New" to add a new Agent.
2. Add New: Then fill up the form with the appropriate data
3. Submit: After filling up the entire form click "Add"

How To Use - Step 04

## Creating Agent Groups

Optimize support workflows and collaboration by organizing agents into purposeful groups using Pixel Desk's Admin Panel. Follow these straightforward steps to create agent groups:

1. Navigate: Select the "Agent Management" option from Menus and then select "Agent Group".
2. Add New:Then click on the "Add New" button
3. Fill The Form: Then fill up the form with the appropriate data
4. Submit: After filling up the entire form click "Add"

Generate A Ticket

## Steps For Users To Generate Tickets

##### Step 1: Click on "Create Ticket" fill up the form and then submit it

##### Step 2: Check ticket status with the tracking number

Create An Account

## How users can make their own accounts to track tickets more efficiently

##### Step 1: Navigate to the registration page

##### Step 2: Add More Tickets By clicking "Create Ticket"

Respond To Ticket

## How An Agent Can Handle A Ticket

##### Step 1: Navigate to the Ticket Lists Option

##### Step 2: Select a ticket to reply them

##### Step 3: With Chat function an Agent can chat with a specific user

## Support

If you have any questions, encounter issues, or need assistance with PixelDesk, our support team is here to help.

Please feel free to reach out to us at:

Open Ticket

We aim to provide prompt and helpful responses to ensure you get the most out of PixelDesk.