{{tag>Logiciel}} ====== osTicket : un système de support par ticket ====== ===== Introduction ===== ===== Pré-requis ===== - Prérequis pour l’installation d’osTicket : * **Serveur Web** sous Windows ou Linux (IIS ou Apache) * **PHP** v5.3 ou supérieur * **MySQL** v5.0 ou supérieur - Recommandé pour disposer de toutes les fonctionnalités :Installez les paquets **[[apt>php-gd,php-imap,php-xml,php-json,php-gettext,php-mbstring,php-intl,php-apcu]]**\\ ou en ligne de commande :$ sudo apt install php-gd php-imap php-xml php-json php-gettext php-mbstring php-intl php-apcu * **php-xml** pour l’envoi de mail en HTML et XML API * **php-json** améliore les performances * **php-gettext** améliore les performances * **php-mbstring** est fortement recommandé pour toutes les installations ===== Installation ===== ==== Mise en place ==== Téléchargez la dernière version d’osTicket sur le site officiel : [[https://osticket.com/download/]] : * ++ Choisissez la version open-source| {{ :logiciel:internet:osticket:osticket_telechargement-01.png?600 |}} ++ * ++ Sélectionnez la dernière version| puis Next step{{ :logiciel:internet:osticket:osticket_telechargement-02.png?600 |}} ++ * ++ Choisissez la langue française| (cliquez sur la flèche pour la mettre en **available** puis Next step :{{ :logiciel:internet:osticket:osticket_telechargement-03.png?600 |}} ++ * ++ Sélectionnez tous les plugins| puis Next step :{{ :logiciel:internet:osticket:osticket_telechargement-04.png?600 |}} ++ * ++ Dans la fenêtre qui s'affiche, cliquez sur No, thanks| en tout petit en bas à gauche :{{ :logiciel:internet:osticket:osticket_telechargement-05.png?600 |}} ++ * ++ Le téléchargement démarre :| {{ :logiciel:internet:osticket:osticket_telechargement-06.png?600 |}} ++ Enregistrez l’archive téléchargée où vous voulez, dézippez-la sur votre ordinateur ((Dézippez aussi l'archive zip contenue dans le premier dézippage)) et envoyez le contenu du dossier **upload** sur votre serveur (via ftp). Vous pouvez renommer ce dossier en **support** (par exemple). L’idéal est de créer un sous-domaine du type **support.monsite.tld** qui pointe vers votre dossier **support**. {{ :logiciel:internet:osticket:osticket-01.png |}} === Passage en français === Via FTP, envoyez le fichier **fr.phar** vers le répertoire **/support/include/i18n** === Premier démarrage et vérifications === Ouvrez votre navigateur et aller à l’adresse : [[http://monsite.tld/support/setup/]] ou [[http://support.monsite.tld]]. Si tout se passe bien, vous devriez tomber sur cette page qui affiche un aperçu des prérequis et de ce qui est activé ou non sur votre serveur. {{ :logiciel:internet:osticket:osticket-02.png?600 |}} Éventuellement, installez ce qui manque et re-testez. Lorsque vous êtes prêt, cliquez sur Poursuivre Une page prévient que le fichier de configuration est manquant : {{ :logiciel:internet:osticket:osticket-03.png?600 |}} Rien de grave, il faut simplement renommer ((par exemple via Filezilla)) le fichier **include/ost-sampleconfig.php** en **include/ost-config.php**. Une fois le fichier renommé, cliquez sur Poursuivre ===== Configuration ===== ==== Configuration de osticket ==== On se retrouve maintenant sur l’écran de configuration des paramètres du CMS : {{ :logiciel:internet:osticket:osticket-04.png?600 |}} Ajoutez vos informations ^ Paramètres système ^ ^ ^ | | Nom du helpdesk | | | | Courriel par défaut | | | | Langue principale | français | ^ Administrateur système ^ ^ ^ | | Prénom | | | | Nom | | | | Adresse e-mail | | | | Nom d'utilisateur | | | | Mot de passe | | ^ Paramètres de base de données ^ ^ ^ | | Préfixe des tables MySQL | ost_ | | | Nom d'hôte MySQL | localhost | | | Base de données MySQL | ost | | | Nom d'utilisateur MySQL | root | | | Mot de passe MySQL | | et cliquez sur Installer maintenant Nommez la base **ost** Si vous avez le message d'erreur : Informations de connexion à la base de données Impossible de se connecter au serveur MySQL : Access denied for user 'root'@'localhost' (using password: YES), voir [[logiciel:sql:mariadb:start#4.1. Débloquer root]] Le message suivant s'affiche : {{ :logiciel:internet:osticket:osticket-05.png?600 |}} Profitez-en pour faire les modifications proposées : via FTP, changez les propriétés du fichier include/ost-config.php :{{ :logiciel:internet:osticket:osticket-06.png |}} Notez les urls indiquées ou imprimez la page : * Vous pouvez ouvrir votre osticket par l'URL indiquée **Votre URL d'osTicket:** :{{ :logiciel:internet:osticket:osticket-07.png?600 |}} * ou le panneau de contrôle par l'URL indiquée **Votre panneau de contrôle personnel:**:{{ :logiciel:internet:osticket:osticket_panneau_de_controle_administrateur.png?600 |}} ==== OsTicket : Time tracking (temps passé sur un ticket) ==== Cette fonctionnalité permet de suivre le temps passé sur un ticket. On peut noter le temps passé sur chaque ticket et l’incrémenter à chaque intervention sur le même sujet, ce qui permet de facturer précisément le temps passé. L’idée est de donc d’implémenter une solution permettant de noter le temps passé sur chaque ticket, pour que je puisse exporter le temps passé en fin de mois sur chaque client dans mon logiciel de facturation. Une entreprise a créé le module osTicket_v1-10-xx_TimeTracking, gratuit et open source. Téléchargez ce module sur la page [[https://www.strobe-it.co.uk/payg/opensource/]] :{{ :logiciel:internet:osticket:timetracking-01.png?600 |}} Dé-compressez cette archive : elle contient un fichier et deux répertoires : * Le fichier texte contient les instructions d’installation. * Les deux répertoires contiennent les fichiers à inclure sur votre serveur web qui fait tourner osTicket. Nous utiliserons les fichiers du répertoire Pre v1-10-4. === Requêtes SQL === Vous allez d’abord devoir apporter des modifications sur la base de données d’osTicket. Un lot de requête à effectuer est proposé dans le fichier texte. Nous utiliserons [[logiciel:internet:adminer:start]]. Choisissez la base de données ost et sélectionnez **Requête SQL**. {{ :logiciel:internet:osticket:adminer-04.png?600 |}} lancez les requêtes indiquées dans le fichier texte de l'archive téléchargée : INSERT INTO ost_list ( name , name_plural , sort_mode , masks , type , notes , created , updated ) VALUES ('Time Type', 'Time Types', 'SortCol', '13', 'time-type', 'Time Spent plugin list, do not modify', NOW(), NOW()); INSERT INTO `ost_list_items` (`list_id`, `status`, `value`, `sort`) SELECT ost_list.id, 1, 'Telephone', 1 FROM ost_list WHERE `name`='Time Type'; INSERT INTO `ost_list_items` (`list_id`, `status`, `value`, `sort`) SELECT ost_list.id, 1, 'Email', 2 FROM ost_list WHERE `name`='Time Type'; INSERT INTO `ost_list_items` (`list_id`, `status`, `value`, `sort`) SELECT ost_list.id, 1, 'Remote', 3 FROM ost_list WHERE `name`='Time Type'; INSERT INTO `ost_list_items` (`list_id`, `status`, `value`, `sort`) SELECT ost_list.id, 1, 'Workshop', 4 FROM ost_list WHERE `name`='Time Type'; INSERT INTO `ost_list_items` (`list_id`, `status`, `value`, `sort`) SELECT ost_list.id, 1, 'Onsite', 5 FROM ost_list WHERE `name`='Time Type'; INSERT INTO ost_config (`namespace`, `key`, `value`, `updated`) VALUES ('core', 'isclienttime', 0, now()), ('core', 'isthreadtime', 0, now()), ('core', 'isthreadtimer', 0, now()), ('core', 'isthreadbill', 0, now()), ('core', 'isthreadbilldefault', 0, now()), ('core', 'istickethardware', 0, now()); ALTER TABLE ost_thread_entry ADD COLUMN time_spent INT( 11 ) UNSIGNED NOT NULL DEFAULT '0' AFTER type; ALTER TABLE ost_thread_entry ADD COLUMN time_type INT( 11 ) UNSIGNED NOT NULL DEFAULT '0' AFTER time_spent; ALTER TABLE ost_thread_entry ADD COLUMN time_bill INT( 11 ) UNSIGNED NOT NULL DEFAULT '0' AFTER time_type; Une fois le lot de requêtes lancé, vous devez obtenir un résultat OK pour chaque requête. === Fichiers additionnels === Via FTP, envoyez les répertoires include et scp sur le serveur : {{ :logiciel:internet:osticket:adminer-05.png?600 |}} === Activation des modules === Sur le panneau d’administration, dans **Paramètres** vous trouvez un nouveau menu **Temps**. Dans ce menu, vous pourrez activer différents points de fonctionnement de votre nouveau module. ===== Utilisation ===== ===== Désinstallation ===== ===== Voir aussi ===== * **(en)** [[http://]] * **(fr)** [[http://]] ---- //Basé sur << [[http://|Article]] >> par Auteur.//