# Définition des conditions

Whether your action will eventually be displayed in Caja file manager context menus or in its toolbar depends on the conditions you will have defined for it.

Il est possible d'imposer des conditions relativement à l'emplacement sur lequel le gestionnaire de fichiers pointe actuellement ou bien relativement aux éléments actuellement sélectionnés dans cet emplacement.

Each time the selection or the location change in the file manager, Caja-Actions checks all your actions, comparing the defined conditions against the new location and selection: all defined conditions must be satisfied in order your action be actually displayed.

## Conditions relatives aux noms de base

Vous pouvez décider que l'action apparaît en fonction du nom de base des éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez définir que chaque élément de la sélection doit entrer dans une certaine typologie de nom de base en vérifiant simultanément qu'aucun élément parmi ceux sélectionnés n'ait un autre type de nom de base.

Click on the Basenames tab to show the page which will permit you to configure your basename-based conditions.

### Conditions relatives aux noms de base

Affiche l'onglet qui vous permet de définir les conditions relatives aux noms de base.

En pratique, les conditions relatives aux noms de base se fondent sur une liste de motifs « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ». Pour que l'action soit candidate compte tenu des conditions relatives aux noms de base, chaque élément de la sélection doit remplir toutes les conditions de la liste : le nom de base de chaque élément doit se conformer à au moins un des motifs « Doit correspondre à l'un des » tout en ne répondant à aucun des motifs « Ne doit correspondre à aucun des ».

Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.

Si l'action cible le menu contextuel de la sélection, les conditions relatives aux noms de base seront vérifiées pour chacun des éléments sélectionnés. Si elle cible le menu contextuel de l'emplacement ou la barre d'outils, les conditions relatives aux noms de base seront vérifiées par rapport au nom de base de l'emplacement actif.

La définition d'une nouvelle condition relative aux noms de base s'effectue en deux étapes.

1. Définir le filtre de la nouvelle condition.

   - Press Insert or click on button to insert a new condition filter

   - Modifiez le filtre de la condition nouvellement ajoutée au nom de base auquel vous souhaitez qu'il se rapporte.

     A basename-based condition may use « `*` » or « `?` » wildcard characters.

2. Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Depending of your target operating system, make sure that the Match case checkbox is activated (or not).

- When activated, all filters are considered as case sensitive, which means that `/my/file` filename is considered distinct from `/My/File` one.

  C'est le comportement par défaut des systèmes de type Unix.

- When deactivated, filters are considered as case insensitive, which means that `/my/file` and `/My/File` filenames are considered the same name.

  This is most probably what you want if you target some sort of Windows system.

Removing a defined basename-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the basename-based condition is just one « `must match one of *` » condition. As all basenames always match the « `*` » condition, this just means that basename-based conditions are not considered as relevant for the action.

## Conditions relatives au type MIME

Vous pouvez décider que votre action apparaît selon les types MIME des éléments de la sélection en cours dans le gestionnaire de fichiers : vous pouvez indiquer que chaque élément de la sélection doit être d'un type MIME donné tout en décidant simultanément qu'aucun élément sélectionné ne doit appartenir à tel ou tel autre type MIME.

Click on the Mimetypes tab to show the page which will permit you to configure your mimetype-based conditions.

### Conditions relatives au type MIME

Affiche l'onglet qui vous permet de définir les conditions relatives aux types MIME.

En pratique, les conditions relatives aux types MIME sont fondées sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit correspondre à aucun des ». Pour que votre action soit candidate en regard des conditions relatives aux types MIME, tout élément de la sélection doit respecter toutes les conditions définies : le type MIME de chaque élément doit correspondre à au moins un des motifs « Doit correspondre à l'un des » tout en ne coïncidant avec aucun des motifs de la colonne « Ne doit correspondre à aucun des ».

Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.

Lors de l'ouverture du menu contextuel de la sélection, les conditions relatives aux types MIME sont vérifiées pour chacun des éléments choisis. Lors de l'ouverture du menu contextuel de l'emplacement ou de la barre d'outils, les conditions relatives au type MIME sont contrôlées vis à vis du type MIME de l'emplacement actuel, qui se trouve être le type MIME bien connu « inode/directory ».

La définition d'une nouvelle condition fondée sur le type MIME s'effectue en deux étapes.

1. Définir le filtre de la nouvelle condition.

   - Press Insert or click on button to insert a new condition filter

   - Définissez le filtre de la condition nouvellement introduite pour le type MIME que vous voulez comparer.

     A mimetype must be defined as a `group/subgroup` expression.

     The « `*` » wildcard is supported only in some situations:

     - The « `*/*` » expression matches all mimetypes. As a convenient shortcut, the « `*` » literal is also accepted for this same purpose.

     - A `group/*` string matches all subgroups of `group` mimetype.

     - The `*/subgroup` string is not accepted as a valid wildcard.

2. Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined mimetype-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the mimetype-based condition is just one « `must match one of */*` » condition. As all mimetypes always match the « `*/*` », this just means that mimetypes are not considered as relevant for the action.

### Exemple de types MIME usuels

`all/all`

- Correspond à tous les éléments.

`all/allfiles`

- Correspond à tous les fichiers réguliers.

`inode/directory`

- Correspond uniquement aux répertoires.

## Conditions relatives aux dossiers

Vous pouvez décider que l'action s'affiche selon le répertoire dans lequel sont contenus les éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez définir que chaque élément de la sélection doit se situer dans telle ou telle partie de l'arborescence des fichiers et, simultanément, ne pas situer dans une autre.

Une condition relative aux dossiers doit se comprendre comme étant la définition de l'arborescence des fichiers dans laquelle l'élément en cours d'examen doit (ou ne doit pas) être situé : c'est un motif de noms de répertoires pour l'élément.

Click on the Folders tab to show the page which will permit you to configure your folder-based conditions.

### Conditions relatives aux dossiers

Affiche l'onglet qui vous permet de définir les conditions relatives aux dossiers.

En pratique, les conditions relatives aux dossiers se fondent sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit pas correspondre à un des ». Pour que l'action soit candidate compte tenu des conditions relatives aux dossiers, chaque élément de la sélection doit être valide pour toutes les conditions fixées : chaque élément doit être situé dans un des dossiers définis dans « Doit correspondre à l'un des » sans appartenir à aucun de ceux définis dans « Ne doit correspondre à aucun des ».

Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.

Quand l'action a pour cible le menu contextuel d'une sélection, les conditions relatives aux dossiers sont vérifiées en examinant le nom du répertoire de chaque élément sélectionné. Quand est ciblé le menu contextuel de l'emplacement ou la barre d'outils, ces mêmes conditions sont contrôlées par rapport à l'emplacement en cours.

La définition d'une nouvelle condition se rapportant à un dossier s'effectue en deux étapes.

1. Définir le filtre de la nouvelle condition.

   - Press Insert or click on button to insert a new condition filter

   - Définir le filtre de la condition nouvellement introduite au dossier que vous voulez comparer.

     The « `*` » and « `?` » characters are accepted as wildcards at any level of the defined folder filter.

   - Or click on Browse to select a folder on the file system.

2. Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined folder-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the folder-based condition is just one « `must match one of /` » condition. As `/` is always the top of an Unix-like file system, then all selected items always match this condition.

If you target a Windows system, then this default value may not be what you actually want.

## Conditions relatives au protocole

Vous pouvez décider que l'action est affichée selon les protocoles des URI des éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez décider que chaque élément de la sélection doit respecter tel ou tel protocole et, simultanément, de pas relever d'un autre.

Click on the Schemes tab to show the page which will permit you to configure your scheme-based conditions.

### Conditions relatives aux protocoles

Affiche l'onglet qui vous permet de définir les conditions relatives aux protocoles.

En pratique, les conditions relatives aux protocoles sont bâties sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit correspondre à aucun des ». Pour que l'action soit candidate selon les conditions relatives aux protocoles, chaque élément de la sélection doit répondre à l'ensemble des conditions précisées : le protocole de chaque élément doit répondre à une au moins des conditions définies dans les motifs « Doit correspondre à l'un des » tout en ne répondant à aucune des conditions « Ne doit correspondre à aucun des ».

Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.

Quand l'action cible le menu contextuel d'une sélection, les conditions relatives aux protocoles sont vérifiées par rapport aux éléments de la sélection actuelle. Quand est ciblé le menu contextuel d'un emplacement ou une barre d'outils, les conditions relatives aux protocoles sont contrôlées relativement au protocole de l'emplacement actuel.

La définition d'une nouvelle condition relative aux protocoles s'effectue en deux étapes.

1. Définir le filtre de la nouvelle condition.

   - Press Insert or click on button to insert a new condition filter

   - Établir le filtre de la condition nouvellement introduite au protocole à vérifier.

     Scheme-based conditions only accept « `*` » wildcard, which stands for « any scheme ».

   - Or click on Common to select a scheme among those predefined in Edit Preferences.

     ### Choix d'un protocole parmi ceux prédéfinis par défaut

     Affiche la liste des protocoles prédéfinis.

     Un nouveau protocole ne peut être sélectionné ici que s'il n'a pas déjà été utilisé dans un autre filtre de protocole.

     To select a new scheme, click OK, or double-click on the desired row.

2. Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined scheme-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the scheme-based condition is just one « `must match one of *` » condition, which means that schemes are not relevant for this action.

## Conditions relatives aux attributs

Les attributs sont des propriétés qu'un fichier peut exposer vis à vis de l'utilisateur.

But except for the `Local` capability, all others depend on the user who executes the command.

You may so decide that your action will appear, or not, depending on the capabilities of the selected item(s) vs. the current user.

Click on the Capabilities tab to show the page which will permit you to configure your capability-based conditions.

### Conditions relatives aux attributs

Affiche la page qui permet de définir les conditions relatives aux attributs.

En pratique, les conditions relatives aux attributs sont bâties sur une liste de motifs « Doit correspondre à tous les » et « Ne doit correspondre à aucun des ». Pour que l'action soit candidate selon les conditions relatives aux attributs, chaque élément de la sélection doit répondre à toutes les conditions définies : l'attribut de chaque élément doit répondre à chacun des attributs précisés dans les motifs « Doit correspondre à tous les » tout en ne répondant à aucun des attributs « Ne doit correspondre à aucun des ».

Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.

When targeting the selection context menu, your capability-based conditions will be checked against the currently selected items. When targeting the location context menu or the toolbar, your capability-based conditions will be checked against those of the current location.

La définition d'une nouvelle condition relative aux attributs s'effectue en deux étapes.

1. Définir le filtre de la nouvelle condition.

   - Press Insert to insert a new condition filter.

   - établissez le filtre de la condition nouvellement introduite à l'attribut à vérifier,

   - Or click on to open the Adding a new capability dialog box.

     ### Attributs pris en charge

     Affiche la liste des attributs pris en charge.

     Un nouvel attribut ne peut être choisi dans cette liste que s'il n'a pas déjà été utilisé dans un autre filtre d'attribut.

     To select a new capability, click OK, or double-click on the desired row.

2. Indiquer s'il s'agit d'une condition « Doit correspondre à tous les » ou « Ne doit correspondre à aucun des ».

   Click on the Must match all of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined capability-based condition is as simple as selecting it, and pressing Del (or clicking on button).

Par défaut, la liste des conditions relatives aux attributs est vide. Cela signifie qu'aucun attribut n'est pertinent pour l'action.

## Condition relative au nombre de sélections

Vous pouvez indiquer que l'action ne s'affiche que si le nombre de fichiers de la sélection actuelle dans le gestionnaire de fichiers possède une valeur ou une relation précise avec le nombre d'éléments donné.

### Exemple d'utilisation d'un décompte de sélection

If your action consists in displaying the differences between two files, you may define here « `Count = (equal to) 2` ».

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

### Conditions relatives à l'environnement

Affiche l'onglet qui permet de définir les conditions relatives à l'environnement. Ces conditions comprennent la configuration du nombre d'éléments sélectionnés, le choix du bureau et les filtres d'exécution.

The selection count condition is defined in the 'Appears if selection contains' frame.

### Encadré de la condition sur le nombre d'éléments sélectionnés

Focus on the Appears if selection contains frame.

Si la cible est le menu contextuel des sélections, les conditions relatives au nombre d'éléments seront vérifiées par rapport au nombre d'éléments de la sélection en cours. Si est ciblé le menu contextuel de l'emplacement ou la barre d'outils, la condition relative au nombre d'éléments sera vérifiée par rapport à zéro étant donné qu'il n'y a pas d'élément sélectionné dans ce cas.

Pour définir une condition sur le nombre d'éléments sélectionnés :

- Select in the Count drop-down list the operator you want apply to the selection count:

  - `<` (strictement plus petit que)
  - `=` (égal à)
  - `>` (strictement plus grand que)

- Saisissez la valeur souhaitée comme référence de décompte.

The selection count defaults to « `Count > (strictly greater than) 0` », which means that the action will be a candidate to be displayed as soon as at least one item is selected in the file manager.

## Sélection du bureau

Vous pouvez définir que l'action :

- apparaît dans tous les cas,

- ou n'apparaît que dans des environnement bureau donnés,

- ou n'apparaît pas dans des environnements de bureau donnés.

Il n'y a qu'un seul choix possible entre ces trois éléments.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The desktop selection is defined in the Desktop environment frame.

### Encadré de sélection du bureau

Focus on the Desktop environment frame.

Pour définir la condition d'environnement de bureau :

1. D'abord sélectionnez le type de filtre :

   - votre action doit-elle toujours apparaître quel que soit l'environnement de bureau ?
   - votre action doit-elle uniquement apparaître dans certains environnements de bureau ?
   - votre action ne doit-elle jamais apparaître dans certains environnements de bureau ?

2. Si l'action ne doit jamais apparaître, sélectionnez ensuite les environnements de bureau concernés dans la liste sur le côté droit.

The targeted desktop environment condition defaults to « `Always appear` », which means that the action will be a candidate to be displayed regardless of the current desktop environment.

## Condition relative à la présence d'un exécutable

Vous pouvez décider que l'action n'apparaît que si un paquet requis est installé sur le système. Dans ce cas, cette vérification s'effectue en recherchant qu'un fichier donné, connu ou supposé connu comme fourni par le paquet, est bien présent dans le système de fichiers et est exécutable.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The executable found condition is defined in the Execution environment frame.

### Encadré de l'environnement d'exécution

Focus on the Execution environment frame.

To define the relevant file, enter its full filename in the Appears if the file is executable entry box, or click on Browse to select a file on the file system.

Laissez ce champ vide si la condition n'est pas pertinente pour l'action.

Vous pouvez intégrer certains paramètres relatifs au fichier recherché. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.

## Condition d'enregistrement D-Bus

Vous pouvez définir que l'action n'apparaît que si un nom donné est enregistré sur le système D-Bus lors de l'exécution.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the relevant name, enter it in the Appears if the name is registered on D-Bus entry box.

Laissez ce champ vide si la condition n'est pas pertinente pour l'action.

Vous pouvez incorporer des paramètres dans le nom à rechercher. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.

## Condition personnalisée

You may define that your action will only appear if some given command outputs a `true` string on its standard output.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

This lets you define your own customized condition filter, by writing a small script which outputs, or not, the `true` string on stdout when it is ran.

To define the command, enter it in the Appears if the command outputs "true" entry box.

Laissez ce champ vide si la condition n'est pas pertinente pour l'action.

Vous pouvez incorporer des paramètres dans le nom du fichier à exécuter ou dans ses options. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.

## Condition relative à un processus en cours d'exécution

Vous pouvez définir que l'action n'apparaît que si un binaire donné est en cours d'exécution.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the binary, enter its name in the Appears if the binary is running entry box, or click on Browse to select a file on the file system.

Même si vous saisissez ici le nom et le chemin du binaire, seul son nom de base sera recherché dans la liste des processus en cours d'exécution.

Laissez ce champ vide si la condition n'est pas pertinente pour l'action.

Vous pouvez incorporer des paramètres dans le nom à rechercher. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.