======NppFTP====== Ce plugin intègre un client FTP au sein de Notepad++ permettant d'éditer "en temps réel" des fichiers distants, voire de synchroniser des projets. Il a été créé par [[http://sourceforge.net/users/harrybharry|Harrybharry]] : * [[http://sourceforge.net/projects/nppftp|Projet sur sourceforge]] * [[http://sourceforge.net/apps/phpbb/nppftp|Forum d'aide]] =====Installation===== Il est intégré par défaut dans Notepad++ depuis la [[:notepadpp:versions?#notepad_57|version 5.7]]. Il peut être installé ou désinstallé simplement depuis le [[plugin_manager|Plugin Manager]]. =====Interface===== L'interface comprend un panneau principal et un panneau d'affichage des messages. ====Panneau principal==== [{{ :notepadpp:plugins:nppftp:panel_ftp.png|Panneau principal de NppFTP}}] Il peut être affiché : * Par le menu //Compléments -> NppFTP -> Show NppFTP Window//, * Par l'icône {{:notepadpp:plugins:nppftp:icon_nppftp.png|Icône de NppFTP}} située à droite de la barre d'icônes. Par défaut ce panneau est présent sur le côté droit de Notepad++. Bien que pouvant être placé n'importe où la structure de son contenu impose une disposition verticale, il vaut donc mieux le placer à droite, à gauche ou le détacher. La barre de menu, composée d'icônes uniquement, comprend les fonctions suivantes : * ''{{:notepadpp:plugins:nppftp:icon_connect.png|Icône de (Dis)Connect}} (Dis)Connect'' permet de se connecter à l'un des profils de connexion listés ou de se déconnecter du profil actuel. * ''{{:notepadpp:plugins:nppftp:icon_download.png|Icône de Download file}} Download file'' télécharge et ouvre le fichier distant sélectionné. //Cette option n'est disponible qu'une fois connecté et un fichier distant sélectionné.// * ''{{:notepadpp:plugins:nppftp:icon_upload.png|Icône de Upload file}} Upload file'' envoie le fichier ouvert dans le dossier distant sélectionné. //Cette option n'est disponible qu'une fois connecté.// * ''{{:notepadpp:plugins:nppftp:icon_refresh.png|Icône de Refresh}} Refresh'' réactualise le dossier distant sélectionné. //Cette option n'est disponible qu'une fois connecté et un dossier distant sélectionné.// * ''{{:notepadpp:plugins:nppftp:icon_abort.png|Icône de Abort}} Abort'' annule l'opération en cours. //Cette option n'est disponible que lorsqu'une opération est en cours.// * ''{{:notepadpp:plugins:nppftp:icon_settings.png|Icône de Settings}} Settings'' : //General settings// ouvre la fenêtre des [[#options_generales|options générales]] et //Profile settings// ouvre la fenêtre de gestion des [[#profils_de_connexion|profils de connexion]]. * ''{{:notepadpp:plugins:nppftp:icon_messageswin.png|Icône de Show message window}} Show messages window'' affiche ou cache le [[#panneau_des_messages|panneau des messages]]. La partie supérieure du panneau est l'explorateur de fichiers distants, la partie inférieure la file d'attente des opérations. Il est possible de déplier ou replier les dossiers et d'en afficher le contenu par un double-clic (cela replie ses sous-dossiers). Le clic droit, une fois un dossier sélectionné, permet dans l'ordre : * d'y créer un nouveau dossier, * d'y créer un nouveau fichier, * de le renommer, * de le supprimer, * d'y envoyer le fichier ouvert, * d'y envoyer un autre fichier (une fenêtre s'ouvre), * de le recharger. Il est possible de télécharger et ouvrir un fichier en double-cliquant dessus. Le clic droit, une fois un fichier sélectionné, permet dans l'ordre : * de le télécharger et l'ouvrir, * de l'enregistrer à un endroit donné (une fenêtre s'ouvre), * de le renommer, * de le supprimer. ====Panneau des messages==== Par défaut ce panneau nommé "//NppFTP - Output//" est placé en bas de Notepad++. [{{ notepadpp:plugins:nppftp:panel_messages.png |Panneau des messages de NppFTP}}] Il liste les ordres d'opérations envoyés au serveur et les messages renvoyés par ce dernier. Mis à part pour chercher des informations sur les causes d'erreurs de connexion ou par curiosité il n'est pas nécessaire de l'afficher. =====Fichiers distants et en cache===== Pour utiliser pleinement ce plugin, il est nécessaire de comprendre son fonctionnement, et ainsi la présence d'une -voire plusieurs- copies locales des fichiers distants. Lorsqu'un fichier distant est ouvert depuis NppFTP, ce dernier le télécharge en local à une adresse définie dans les [[#global_cache|options]] ou dans le [[#cache|profil]] de la connexion, en reproduisant l'arborescence des dossiers. Cette arborescence locale, correspondant à une copie partielle de l'arborescence distante, est appelée ''Cache''. Les fichiers en cache sont synchronisés avec leur version distante par le biais de NppFTP : lorsqu'un fichier en cache est modifié depuis Notepad++, qu'il ait été ouvert depuis NppFTP ou non, ce dernier en envoie automatiquement une copie sur le serveur qui écrase le fichier distant. =====Options générales===== Cette fenêtre contient les options du comportement général du plugin. [{{ notepadpp:plugins:nppftp:win_settings.png |Fenêtre d'options générales de NppFTP}}] ===Global cache=== Chemin local par défaut où recréer l'arborescence distante et stocker les fichiers téléchargés. Ce chemin peut être définit spécifiquement pour un profil de connexion, cette valeur ne sera alors pas prise en compte. Par défaut, cette valeur est à : <code>%CONFIGDIR%\Cache\%USERNAME%@%HOSTNAME%</code> ''%CONFIGDIR%'' correspond au chemin vers le fichier de configuration du plugin, dans les données utilisateur de Notepad++. ''%USERNAME%'' correspond à l'identifiant de connexion au serveur distant, et ''%HOSTNAME%'' au nom de ce serveur. Par exemple, sous Windows 7, pour un dialogue avec le serveur ''myserver.com'' avec l'identifiant ''admin'', les fichiers seront stockés en local à l'adresse : <code>C:/Users/user/AppData/Roaming/Notepad++/plugins/config/NppFTP/Cache/admin@myserver.com/</code> C'est un chemin assez fastidieux, n'hésitez donc pas à personnaliser cette valeur. ===Clear ENTIRE cache on disconnect=== Avec cette option cochée NppFTP supprimera les fichiers stockés en local (voir Global Cache) à chaque déconnexion. Cela implique donc de re-télécharger les fichiers à chaque connexion. Si la sous-option ''Do not use the recycle bin'' est cochée, les fichiers ne passeront pas par la Corbeille et ne pourront être restaurés. ===Master password=== Mot de passe par défaut. =====Profils de connexion===== Cette fenêtre permet de créer et de paramétrer des profils de connexion, décrivant principalement comment et à quoi se connecter. Elle est composée de deux partie : la partie de gauche permet de gérer les profils quand la partie de droite permet de les paramétrer. [{{ notepadpp:plugins:nppftp:win_profiles.png |Fenêtre de gestion des profils de connexion de NppFTP}}] ====Gestion des profils==== La zone située à gauche nommée ''Profiles'' liste les profils de connexions enregistrés. Vous pouvez sélectionner un profil pour afficher ses paramètres dans les onglets. Les boutons situés en bas permettent d'ajouter un nouveau profil et de renommer, de dupliquer ou de supprimer le profil sélectionné. ====Connection==== Ces paramètres doivent nécessairement être renseignés - au minimum ''Hostname'', ''Username'' et ''Password'' - pour mettre en place une connexion. Vous les trouverez généralement dans les informations fournies par votre hébergeur. [{{ notepadpp:plugins:nppftp:win_profiles_connection.png |Paramètres de connection de NppFTP}}] ==Hostname== Le nom du serveur auquel se connecter. Par exemple : <code>domain.tld</code> ==Connection type== Le protocole de connexion à utiliser : * ''FTP'' pour une connexion standard ([[wpfr>FTP|File Transfert Protocol]]), * ''FTPES'' ou ''FTPS'' pour une connexion sécurisée par un protocole [[wpfr>SSL|SSL]] ([[wpfr>FTPS|File Transfert Protocol over SSL]]), * ''SFTP'' pour une connexion sécurisée par un protocole [[wpfr>SSH|SSH]] ([[wpfr>SSH_File_Transfert_Protocol|SSH File Transfert Protocol]]). Par défaut ''FTP''. ==Port== Numéro de [[wpfr>Port_(logiciel)|port]]. Par défaut ''21'' (FTP), quelquefois ''22'' (SFTP). ==Username== Nom d'utilisateur sous lequel se connecter. Par exemple : <code>myname</code> ==Password== Mot de passe de l'utilisateur. Par exemple : <code>mygreatpassword</code> L'option ''Ask for password'' permet de ne pas stocker ce mot de passe dans NppFTP, mais de le demander à chaque connexion. ==Timeout== Temps maximum (en secondes) pendant lequel NppFTP attends une réponse du serveur. Une fois ce temps écoulé, il indiquera ne pas avoir obtenu de réponse. Par défaut ''30''. ==Initial remote directory== Dossier de l'arborescence distante à ouvrir à la connexion. Par exemple : <code>/www/directory/goodplace</code> A la connexion, l'explorateur de fichiers dépliera automatiquement l'arborescence jusqu'au point indiqué. Par exemple : <code> / www directory goodplace file1 file2 ... </code> ====Authentification==== Cet onglet permet de définir les méthodes d'authentification pour une connexion sécurisée au serveur. [{{ notepadpp:plugins:nppftp:win_profiles_authentification.png |Paramètres d'authentification de NppFTP}}] ==Try private key file authentification== Si coché le client FTP tentera de s'authentifier via une paire de clés publique/privée. Il est alors nécessaire d'indiquer le chemin vers le fichier contenant la clé privée avec le paramètre ''Private key file'' et la phrase de sécurité avec le paramètre ''Passphrase''. ==Try password authentification== Si coché le client FTP tentera de s'authentifier via mot de passe. Par défaut. ==Try keyboard interactive authentification== Si coché le client FTP tentera de s'authentifier via la méthode ''[[http://snailbook.com/docs/keyboard-interactive.txt|keyboard-interactive]]''. ====Transfers==== [{{ notepadpp:plugins:nppftp:win_profiles_transfers.png |Paramètres de transferts de NppFTP}}] ====FTP Misc.==== Le paramètre ''LIST parameters'' permet de renseigner les paramètres de la [[http://www.commentcamarche.net/contents/internet/ftp.php3#les-commandes-ftp|commande FTP]] envoyée au serveur pour lister les fichiers. Ce paramètre permet d'influencer directement ce qui est affiché dans l'explorateur. * ''-al'' inclus les fichiers cachés. [{{ notepadpp:plugins:nppftp:win_profiles_misc.png |Paramètres des commandes FTP de NppFTP}}] ====Cache==== Cet onglet permet de définir pour chaque profil de connexion des lieux spécifiques où stocker le cache de certaines zones de l'arborescence distante. Si un fichier se trouve en dehors des chemins distants définis ici, il sera stocké à l'adresse définie dans les [[#global_cache|options générales]]. [{{ notepadpp:plugins:nppftp:win_profiles_cache.png |Paramètres de cache de NppFTP}}] ==Profile cache maps== Liste des associations faites entre un chemin local et un chemin distant. Sélectionner une association pour voir ses paramètres. Utiliser le bouton ''Add new'' pour ajouter une nouvelle association, ''Edit'' pour enregistrer les changements effectués, ''Delete'' pour supprimer l'association sélectionnée. ==Local Path== Chemin local où enregistrer le cache de l'arborescence distante définie par ''External Path''. Par exemple : <code>C:/Users/user/Desktop/</code> ==External path== Point d'origine dans l'arborescence distante à partir duquel les fichiers en cache seront stockés à l'adresse définie par ''Local Path''. Par exemple : <code>/www/directory/goodplace</code> ===Exemple=== Prenons une arborescence distante structurée ainsi : <code> www project page index.html style.css something.txt scenario scenario.txt better_scenario.html </code> Par défaut tous les fichiers seraient stockés en cache à l'adresse définie dans les options globales de NppFTP : <code> path to the Cache www project page index.html style.css something.txt scenario scenario.txt better_scenario.html </code> Si toutefois nous paramétrons les associations suivantes : <code> Local Path : C:/My great project/ External Path : /www/project/page </code> et <code> Local Path : D:/Scenarios/ External Path : /www/scenario </code> Le contenu de ''page'' serait alors stocké selon la première association... <code> C:/My great project index.html style.css </code> Le contenu de ''scenario'' selon la seconde... <code> C:/scenario scenario.txt better_scenario.html </code> Et les fichiers ne correspondant pas aux associations faites selon les options : <code> path to the Cache www project something.txt </code>