Documentation ComusThumbz
Connexion Admin

Éditeur de fichiers

Ce que fait cette page

L'éditeur de fichiers vous permet de modifier les fichiers de votre site Web directement à partir du panneau d'administration -- aucun logiciel séparé n'est nécessaire. Vous pouvez mettre à jour le contenu de la page, modifier l'apparence de votre site, modifier les traductions, et plus encore, à partir de votre navigateur. Il fonctionne comme une version simplifiée d'un éditeur de code professionnel avec du texte codé en couleur, plusieurs fichiers ouverts, et un historique intégré pour que vous puissiez annuler les erreurs.

Avertissement : Les changements que vous faites ici vont en direct immédiatement. Il n'y a pas d'étape d'aperçu. Utilisez toujours l'historique des versions pour créer un filet de sécurité avant d'apporter de gros changements.

[Screenshot: page-overview]


Comment arriver ici

Naviguez vers Panneau d'administration > Gestionnaire de modèles > Fichiers


Comprendre la page

Lorsque vous ouvrez l'éditeur de fichiers, vous voyez trois zones principales côte à côte.

Navigateur de fichiers (côté gauche)

C'est votre liste de fichiers. Il montre tous les fichiers et dossiers sur votre site Web que vous pouvez éditer, organisé dans un arbre de dossiers -- tout comme le navigateur de fichiers sur votre ordinateur. Cliquez sur un dossier pour l'agrandir et voir ce qui est à l'intérieur. Cliquez sur un fichier pour l'ouvrir.

En haut du navigateur de fichiers, vous trouverez :

  • A boîte de recherche pour trouver rapidement des fichiers par nom
  • A Actualiser bouton pour recharger la liste de fichiers
  • A Nouveau fichier bouton pour créer un nouveau fichier
  • A Nouveau dossier bouton pour créer un nouveau dossier

Conseil : Tapez une partie d'un nom de fichier dans la zone de recherche et la liste se rétrécit instantanément. Dossiers contenant des allumettes s'ouvrent automatiquement afin que vous puissiez trouver ce dont vous avez besoin rapidement.

Espace éditeur (Centre)

C'est là que vous apportez des modifications à vos fichiers. Lorsque vous ouvrez un fichier, son contenu apparaît ici avec un texte en couleur qui facilite la lecture. Si vous ouvrez plus d'un fichier, chacun obtient son propre onglet en haut -- cliquez sur un onglet pour basculer entre les fichiers.

Au-dessus de l'éditeur, vous verrez une barre d'outils avec :

  • Les chemin du fichier montrant le fichier que vous modifiez
  • A Rechercher bouton pour rechercher dans le fichier
  • A Présentation bouton pour ranger le code automatiquement
  • A Enregistrer bouton pour enregistrer vos modifications

Quand aucun fichier n'est ouvert, vous verrez un message vous demandant de sélectionner un fichier dans le navigateur de fichier.

Panneau d'historique (côté droit)

Chaque fois que vous enregistrez un fichier, un instantané est stocké ici. Ce panneau montre l'historique complet des changements pour le fichier que vous modifiez actuellement -- qui l'a modifié, quand et quel type de changement a été fait. Plus important encore, vous pouvez restaurer n'importe quelle version précédente en un seul clic.

Remarque: Si vous n'avez pas besoin du panneau d'historique, vous pouvez le fermer en utilisant le bouton X dans son en-tête. La zone de l'éditeur s'étend pour remplir l'espace supplémentaire.

Tâches communes

Comment ouvrir un fichier

  1. Regardez le navigateur de fichiers sur le côté gauche de la page.
  2. Cliquez sur les noms de dossiers pour les agrandir et voir les fichiers à l'intérieur.
  3. Cliquez sur le fichier à modifier.
  4. Le fichier s'ouvre dans la zone de l'éditeur avec son propre onglet.
Conseil : Vous pouvez avoir plusieurs fichiers ouverts en même temps. Chaque fichier a son propre onglet. Cliquez sur n'importe quel onglet pour passer à ce fichier.

Comment modifier un fichier

  1. Ouvrez le fichier que vous voulez modifier.
  2. Cliquez dans la zone de l'éditeur et faites vos modifications.
  3. Comme vous tapez, un petit point jaune apparaît sur l'onglet du fichier pour vous faire savoir que vous avez des changements non enregistrés.

raccourcis clavier utiles lors de l'édition :

RaccourciCe qu'il fait
Ctrl+ZDéfaire votre dernière modification
Ctrl+YRefaire un changement que vous n'avez pas fait
Ctrl+FRecherche dans le fichier
Ctrl+HRechercher et remplacer le texte

Comment enregistrer vos modifications

  1. Après avoir fait vos modifications, cliquez sur Enregistrer bouton dans la barre d'outils, ou appuyez sur Ctrl+S sur votre clavier.
  2. Une notification verte apparaît dans le coin inférieur droit confirmant que l'enregistrement a été réussi.
  3. Le point jaune sur l'onglet disparaît, ce qui signifie que tous les changements sont enregistrés.
  4. Une nouvelle entrée apparaît dans le panneau d'historique à droite.
Avertissement : Si vous essayez de fermer un onglet ou de laisser la page avec des changements non enregistrés, votre navigateur vous demandera si vous êtes sûr. Cliquez sur Annuler pour revenir sauver votre travail d'abord.

Comment créer un nouveau fichier

  1. Cliquez sur Nouveau fichier bouton (le fichier avec un signe plus) en haut du navigateur de fichier.
  2. Une boîte de dialogue s'ouvre. Sélectionnez la dossier où vous voulez créer le fichier à partir de la liste déroulante.
  3. Type a nom pour votre fichier, y compris l'extension de fichier (par exemple, custom.css ou about.php).
  4. Cliquez sur Créer un fichier.
  5. Le nouveau fichier apparaît dans le navigateur du fichier et s'ouvre automatiquement, prêt à être édité.
Remarque: Chaque dossier ne permet que certains types de fichiers. Par exemple, le dossier styles permet uniquement les fichiers de feuille de style. Les types autorisés sont affichés dans la liste déroulante pour vous aider à choisir le bon emplacement.

Comment créer un nouveau dossier

  1. Cliquez sur Nouveau dossier bouton (le dossier avec un signe plus) en haut du navigateur de fichiers.
  2. Sélectionnez la dossier parent où le nouveau dossier doit être créé.
  3. Type a nom pour votre nouveau dossier.
  4. Cliquez sur Créer un dossier.
  5. Le nouveau dossier apparaît dans le navigateur du fichier.

Comment renommer un fichier ou un dossier

  1. Faites un clic droit sur le fichier ou le dossier que vous souhaitez renommer.
  2. Sélectionner Renommer dans le menu qui apparaît.
  3. Le nom actuel est déjà rempli. Changez-le en un nouveau nom.
  4. Cliquez sur Renommer.
  5. Le fichier ou le dossier est rebaptisé et le navigateur de fichiers est mis à jour.
Conseil : Lorsque vous renommez un fichier, assurez-vous de conserver l'extension de fichier correcte (la partie après le point, comme .php ou .css). Changer l'extension pourrait causer des problèmes.

Comment supprimer un fichier ou un dossier

  1. Faites un clic droit sur le fichier ou le dossier que vous souhaitez supprimer.
  2. Sélectionner Supprimer dans le menu qui apparaît.
  3. Une boîte de dialogue de confirmation apparaît montrant ce qui sera supprimé. Cliquez sur Très bien. poursuivre.
  4. L'élément est supprimé du navigateur du fichier. Si le fichier était ouvert dans un onglet, l'onglet se ferme automatiquement.
Avertissement : La suppression d'un fichier ne peut être annulée par l'interface normale. Cependant, si le fichier a été précédemment enregistré par l'éditeur, vous pourriez être en mesure de récupérer son contenu à partir de l'historique de la version. Pour être en sécurité, enregistrez toujours un fichier au moins une fois avant de le supprimer.
Remarque: Les dossiers doivent être vides avant de pouvoir les supprimer. Supprimez tous les fichiers dans un dossier, puis supprimez le dossier lui-même.

Comment rechercher un fichier

Trouver un fichier dans le navigateur de fichiers :

  1. Tapez une partie du nom de fichier dans la boîte de recherche en haut du navigateur de fichiers.
  2. La liste des fichiers filtres instantanément pour montrer seulement les fichiers correspondants.
  3. Les dossiers contenant des allumettes s'étendent automatiquement.
  4. Effacer la zone de recherche pour voir tous les fichiers à nouveau.

Trouver du texte dans un fichier :

  1. Ouvrez le fichier que vous voulez rechercher.
  2. Cliquez sur Rechercher bouton dans la barre d'outils, ou appuyez sur Ctrl+F.
  3. Une barre de recherche apparaît en haut de l'éditeur. Tapez ce que vous cherchez.
  4. Utilisez les boutons de flèche pour sauter entre les allumettes.
  5. Appuyez sur Échappement fermer la barre de recherche.

Comment formater le code

  1. Ouvrez le fichier que vous voulez ranger.
  2. Cliquez sur Présentation bouton dans la barre d'outils.
  3. L'éditeur ajuste automatiquement l'espacement et l'alignement pour rendre le code plus propre et plus facile à lire.
Conseil : Le formatage fonctionne particulièrement bien pour JavaScript et les fichiers de traduction. C'est un moyen rapide de nettoyer le code désordonné sans changer ce que le code fait.

Historique des versions et restauration des fichiers

L'historique des versions est l'une des caractéristiques de sécurité les plus importantes de l'éditeur de fichiers. Chaque fois que vous enregistrez, créez, supprimez ou restaurez un fichier, une sauvegarde complète du contenu du fichier est enregistrée.

Comment afficher l'historique d'un fichier

  1. Ouvrez le fichier dans l'éditeur.
  2. Regardez Historique panneau sur le côté droit de la page.
  3. Chaque entrée indique:
  • Les type de changement (Créé, modifié, supprimé ou restauré)
  • Les date et heure du changement
  • Qui fait le changement

Comment restaurer une version précédente

Si vous avez fait un changement qui a cassé quelque chose ou vous voulez revenir à une version antérieure:

  1. Ouvrez le fichier que vous voulez restaurer.
  2. Dans Historique panneau, trouvez la version à laquelle vous voulez retourner.
  3. Cliquez sur Restauration bouton à côté de cette version.
  4. Confirmez quand vous êtes invité.
  5. Le fichier est rétabli dans cette version immédiatement.
Succès : Après la restauration, une nouvelle entrée est ajoutée à l'historique marquant la restauration. Cela signifie que vous pouvez même annuler une restauration si vous changez d'avis -- il suffit de restaurer la version qui était en cours avant que vous rouliez.

Quels fichiers pouvez-vous éditer?

L'éditeur de fichiers vous donne accès aux fichiers frontend qui composent votre site Web public. Il s'agit notamment :

Ce que vous pouvez modifierCe qu'il contrôle
Pages du site WebLes pages principales visiteurs voir (page d'accueil, pages vidéo, pages de galerie, etc.)
Feuilles de styleComment votre site ressemble -- couleurs, polices, espacement et mise en page
ScriptsCaractéristiques interactives et comportement sur votre site
Fichiers de traductionTout le texte affiché sur votre site dans chaque langue
Pages de connexion et d'enregistrementLes pages où les utilisateurs se connectent et créent des comptes
Paramètres des pages utilisateurPages où les utilisateurs gèrent leur compte et leurs préférences
Pages d'informationPages d'information, juridiques et autres
Fichiers thématiquesFichiers appartenant à vos thèmes installés
Remarque: Certains fichiers apparaissent diminués dans le navigateur de fichiers. Ce sont des fichiers système protégés qui ne peuvent pas être modifiés par cet outil. Il s'agit d'une caractéristique de sécurité pour prévenir les changements accidentels aux fichiers critiques.

Le menu de droite

Le clic droit sur n'importe quel fichier ou dossier du navigateur ouvre un menu à action rapide :

OptionCe qu'il fait
OuvrirOuvre le fichier pour l'édition (fichiers seulement)
RenommerModification du nom du fichier ou du dossier
AutorisationsAjuste qui peut lire ou écrire le fichier (avancée -- voir ci-dessous)
SupprimerSupprime le fichier ou le dossier

Cliquez n'importe où hors du menu ou appuyez sur Échappement fermer sans choisir une option.


Autorisations de dossier (Avancé)

Remarque: La plupart des utilisateurs n'auront jamais besoin de changer les permissions de fichier. Cette fonctionnalité est ici pour les situations avancées où un fichier a besoin de différents paramètres d'accès. Si vous n'êtes pas sûr, laissez les permissions comme elles sont.

Si vous avez besoin de modifier les permissions:

  1. Faites un clic droit sur le fichier ou le dossier.
  2. Sélectionner Autorisations.
  3. Saisissez la valeur de permission. Les valeurs les plus courantes sont:
  • 644 -- Réglage standard des fichiers réguliers
  • 755 -- Réglage standard des dossiers
  1. Cliquez sur Appliquer.

Conseils pour les nouveaux utilisateurs

Conseil :
  • Sauvez souvent. Appuyez fréquemment sur Ctrl+S pendant le travail. Chaque sauvegarde crée une sauvegarde que vous pouvez restaurer plus tard.
  • Commencez petit. Faites un changement à la fois, économisez, puis vérifiez votre site pour vous assurer que tout semble bien avant d'apporter plus de changements.
  • Utilisez la recherche. Si vous ne savez pas quel fichier modifier, utilisez la boîte de recherche pour trouver des fichiers par nom.
  • Vérifiez votre site après avoir économisé. Ouvrez votre site Web dans un nouvel onglet de navigateur et rafraîchissez la page pour voir vos changements dans l'action.
  • Ne modifiez pas les fichiers avec lesquels vous n'êtes pas familier. Changer le mauvais fichier peut briser votre site. S'en tenir aux fichiers que vous comprenez, comme les feuilles de style pour les changements visuels ou les fichiers de traduction pour les changements de texte.
  • Utilisez l'historique des versions comme filet de sécurité. Avant de faire un changement important, notez la version actuelle dans le panneau d'historique. Si quelque chose tourne mal, vous pouvez le restaurer.

Dépannage

Un fichier ne s'ouvrira pas lorsque je cliquerai dessus

Ce que vous voyez : Vous cliquez sur un fichier dans le navigateur de fichiers mais rien ne se passe, ou vous voyez un message d'erreur.

Comment le réparer :

  1. Vérifiez si le fichier apparaît diminué ou grisé. Les fichiers diminués sont protégés et ne peuvent pas être modifiés -- c'est normal.
  2. Les fichiers très gros (plus de 5 Mo) ne peuvent pas être ouverts dans l'éditeur. Si vous avez besoin de modifier un grand fichier, contactez votre développeur ou administrateur système.
  3. Essayez de rafraîchir la page en utilisant la Actualiser bouton en haut du navigateur de fichier, ou appuyez sur F5 pour recharger toute la page.

Mes changements ne seront pas enregistrés

Ce que vous voyez : Vous cliquez sur Enregistrer ou appuyez sur Ctrl+S mais obtenez un message d'erreur au lieu d'une confirmation.

Comment le réparer :

  1. Vérifiez s'il y a une bannière orange en haut de la page qui indique que l'éditeur est en mode démo. En mode démo, tous les changements sont bloqués. Contactez votre administrateur pour désactiver le mode démo.
  2. Essayez de rafraîchir la page et de faire vos changements à nouveau. Parfois la session expire et un nouveau chargement de page corrige le problème.
  3. Si le problème continue, contactez votre administrateur système. Il peut y avoir un problème de permission du serveur qui doit être résolu.

La zone de l'éditeur est vide ou ne sera pas chargée

Ce que vous voyez : La zone centrale où vous modifiez des fichiers est vide ou affiche un message de chargement qui ne se termine jamais.

Comment le réparer :

  1. Assurez-vous d'utiliser un navigateur à jour (Chrome, Firefox ou Edge). Les navigateurs plus anciens peuvent ne pas supporter l'éditeur.
  2. Essayez de supprimer le cache de votre navigateur et de recharger la page.
  3. Si vous utilisez une extension de navigateur qui bloque des ressources externes (comme un bloqueur de publicité ou une extension de confidentialité), essayez de la désactiver temporairement. L'éditeur compte sur une ressource externe pour fonctionner.

Le panneau d'historique est vide

Ce que vous voyez : Vous ouvrez un fichier mais le panneau d'historique à droite ne montre rien.

Comment le réparer :
Ceci est normal pour les fichiers qui n'ont jamais été édités par l'éditeur de fichiers avant. L'historique commence à enregistrer après votre premier enregistrement. Une fois que vous enregistrez le fichier au moins une fois, les changements futurs apparaîtront dans l'historique.

Je ne peux pas supprimer un dossier

Ce que vous voyez : Vous essayez de supprimer un dossier mais obtenez un message d'erreur.

Comment le réparer :

  1. Assurez-vous que le dossier est complètement vide. Vous devez supprimer tous les fichiers et sous-dossiers à l'intérieur avant de pouvoir supprimer le dossier lui-même.
  2. Vérifiez s'il y a des fichiers cachés dans le dossier. Si oui, contactez votre administrateur système pour les aider à les supprimer.


PageQuand l'utiliser
Tableau de bord du modèlePour un aperçu de tous les outils de gestion des modèles et un accès rapide à chacun
Gestionnaire de thèmesLorsque vous voulez changer entre des thèmes de site complets ou installer de nouveaux
Gestionnaire de styleLorsque vous voulez changer les couleurs, les polices et l'espacement en utilisant des contrôles simples au lieu de modifier le code directement
Gestionnaire de la traductionLorsque vous voulez modifier le texte qui apparaît sur votre site dans différentes langues à l'aide d'une interface de traduction dédiée

Ce guide fait partie de la documentation d'administration de ComusThumbz.