# Definir las condiciones

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.

Las condiciones se podrán comparar con el lugar al que el gestor de archivos actualmente apunta, o con los elementos actualmente seleccionados en este lugar.

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.

## Condiciones basadas en el nombre base

Puede decidir si su acción aparecerá dependiendo de los nombres base de los elementos actualmente seleccionados en el gestor de archivos: puede definir que cada elemento de la selección deba tener algún tipo de ordenación según su nombre base, y puede decidir simultáneamente que ninguno de los elementos seleccionados pueda tener algún otro tipo de nombre base.

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

### Condiciones basadas en el nombre base

Muestra la pestaña que le permite definir sus condiciones basadas en nombres base.

En realidad, las condiciones basadas en nombres base se construyen como una lista con dos tipos de condiciones: «debe cumplir al menos una» y «no debe cumplir ninguna». Para que su acción sea un candidato tomando en cuenta estas condiciones basadas en nombres base, todas las condiciones listadas deben ser válidas para cada uno de los elementos seleccionados: el nombre base de cada elemento debe cumplir al menos una de las condiciones del tipo «debe cumplir al menos una» y no debe cumplir ninguna del tipo «no debe cumplir ninguna».

Si al menos un elemento de la selección no cumple todas las condiciones definidas, entonces su acción no se mostrará.

Cuando el objetivo sea el menú contextual de la selección, sus condiciones basadas en nombres base se compararán con los elementos actualmente seleccionados. Cuando el objetivo sea el menú contextual del lugar actual o la barra de herramientas, sus condiciones basadas en nombres base se compararán con el nombre base del lugar actual.

Definir una condición nueva basada en el nombre base nueva implica dos pasos.

1. Defina el filtro de la nueva condición.

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

   - Edite el filtro de la condición para que coincida con el nombre base que quiere.

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

2. Indica si esta es una condición del tipo «debe cumplir al menos una» o «no debe cumplir ninguna».

   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.

  Este es el comportamiento predeterminado en los sistemas similares a 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.

## Condiciones basadas en tipos MIME

Puede decidir si su acción aparecerá dependiendo de los tipos MIME de los elementos actualmente seleccionados en el gestor de archivos: puede definir que cada elemento de la selección deba cumplir algún tipo MIME; y puede simultáneamente decidir que ninguno de los elementos seleccionados deba cumplir algún otro tipo MIME.

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

### Condiciones basadas en tipos MIME

Muestra la pestaña que le permite definir sus condiciones basadas en tipos MIME.

En realidad, las condiciones basadas en tipos MIME se construyen como una lista con dos tipos de condiciones: «debe cumplir al menos una» y «no debe cumplir ninguna». Para que su acción sea un candidato tomando en cuenta estas condiciones basadas en tipos MIME, todas las condiciones listadas deben ser válidas para cada uno de los elementos seleccionados: el tipo MIME de cada elemento debe cumplir al menos una de las condiciones del tipo «debe cumplir al menos una» y no debe cumplir ninguna del tipo «no debe cumplir ninguna».

Si al menos un elemento de la selección no cumple todas las condiciones definidas, entonces su acción no se mostrará.

Cuando el objetivo sea el menú contextual de la selección, sus condiciones basadas en tipos MIME se compararán con los elementos actualmente seleccionados. Cuando el objetivo sea el menú contextual del lugar actual o la barra de herramientas, sus condiciones basadas en tipos MIME se compararán con el tipo MIME del lugar actual, que resulta ser el conocido tipo MIME « inode/directory ».

Definir una condición basada en tipo MIME implica dos pasos.

1. Defina el filtro de la nueva condición.

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

   - Edite el filtro de la condición para que coincida con el tipo MIME que quiere.

     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. Indica si esta es una condición del tipo «debe cumplir al menos una» o «no debe cumplir ninguna».

   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.

### Ejemplo de tipos MIME habituales

`all/all`

- Coincide con todos los elementos.

`all/allfiles`

- Coincide con todos los archivos regulares.

`inode/directory`

- Coincide sólo con carpetas.

## Condiciones basadas en carpetas

Puede decidir si su acción aparecerá dependiendo de la carpeta en la que se encuentran los elementos actualmente seleccionados en el gestor de archivos: puede definir que cada elemento de la selección deba estar en una jerarquía u otra; y puede simultáneamente decidir que ninguno de los elementos seleccionados deba estar en alguna otra jerarquía.

Una condición basada en carpetas se debe ser entender como la especificación de la jerarquía en la que el elemento actualmente examinado debería (o no) estar: Esto es un patrón en la ruta del elemento.

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

### Condiciones basadas en carpetas

Muestra la pestaña que le permite definir condiciones basadas en carpetas.

En realidad, las condiciones basadas en carpetas se construyen como una lista con dos tipos de condiciones: «debe cumplir al menos una» y «no debe cumplir ninguna». Para que su acción sea un candidato tomando en cuenta estas condiciones basadas en carpetas, todas las condiciones listadas deben ser válidas para cada uno de los elementos seleccionados: cada elemento debe estar colocado en una de las carpetas del tipo «debe cumplir al menos una» definidas y no debe estar en ninguna del tipo «no debe cumplir ninguna».

Si al menos un elemento de la selección no cumple todas las condiciones definidas, entonces su acción no se mostrará.

Cuando el objetivo sea el menú contextual de la selección, sus condiciones basadas en carpetas se compararán con el nombre de la ruta de cada elemento seleccionado. Cuando el objetivo sea el menú contextual del lugar actual o la barra de herramientas, sus condiciones basadas en carpetas se compararán con el lugar actual.

Definir una condición nueva basada en carpetas implica dos pasos.

1. Defina el filtro de la nueva condición.

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

   - Edite el filtro de la condición para que coincida con la carpeta que quiere.

     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. Indica si esta es una condición del tipo «debe cumplir al menos una» o «no debe cumplir ninguna».

   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.

## Condiciones basadas en esquemas

Puede decidir si su acción aparecerá dependiendo de los esquemas de los URI de los elementos actualmente seleccionados en el gestor de archivos: puede definir que cada elemento de la selección deba tener algún esquema; y puede simultáneamente decidir que ninguno de los elementos seleccionados deba tener algún otro esquema.

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

### Condiciones basadas en esquemas

Muestra la pestaña que le permite definir sus condiciones basadas en esquemas.

En realidad, las condiciones basadas en esquemas se construyen como una lista con dos tipos de condiciones: «debe cumplir al menos una» y «no debe cumplir ninguna». Para que su acción sea un candidato tomando en cuenta estas condiciones basadas en esquemas, todas las condiciones listadas deben ser válidas para cada uno de los elementos seleccionados: el esquema de cada elemento debe cumplir al menos una de las condiciones del tipo «debe cumplir al menos una» y no debe cumplir ninguna del tipo «no debe cumplir ninguna».

Si al menos un elemento de la selección no cumple todas las condiciones definidas, entonces su acción no se mostrará.

Cuando el objetivo sea el menú contextual de la selección, sus condiciones basadas en esquemas se compararán con los elementos actualmente seleccionados. Cuando el objetivo sea el menú contextual del lugar o la barra de herramientas, sus condiciones basadas en esquemas se compararán con el esquema del lugar actual.

Definir una condición nueva basada en esquemas implica dos pasos.

1. Defina el filtro de la nueva condición.

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

   - Edite el nuevo filtro de condición insertado para que coincida con el esquema que quiere.

     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.

     ### Seleccionar un esquema entre los predeterminados

     Muestra la lista de esquemas predefinidos.

     Podrá seleccionar aquí un esquema nuevo únicamente si no está definido ya como un filtro de esquema.

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

2. Indica si esta es una condición del tipo «debe cumplir al menos una» o «no debe cumplir ninguna».

   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.

## Condiciones basadas en capacidades

Las capacidades son algunas propiedades que un archivo puede mostrarle al usuario.

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.

### Condiciones basadas en capacidades

Muestra la pestaña que le permite definir sus condiciones basadas en capacidades.

En realidad, las condiciones basadas en capacidades se construyen como una lista con dos tipos de condiciones: «debe cumplir al menos una» y «no debe cumplir ninguna». Para que su acción sea un candidato tomando en cuenta estas condiciones basadas en capacidades, todas las condiciones listadas deben ser válidas para cada uno de los elementos seleccionados: la capacidad de cada elemento debe cumplir al menos una de las capacidades del tipo «debe cumplir al menos una» y no debe cumplir ninguna del tipo «no debe cumplir ninguna».

Si al menos un elemento de la selección no cumple todas las condiciones definidas, entonces su acción no se mostrará.

Cuando el objetivo sea el menú contextual de la selección, sus condiciones basadas en capacidades se compararán con los elementos actualmente seleccionados. Cuando el objetivo sea el menú contextual del lugar o la barra de herramientas, sus condiciones basadas en capacidades se compararán con aquellas del lugar actual.

Definir una condición basada en capacidades nueva implica dos pasos.

1. Defina el filtro de la nueva condición.

   - Press Insert to insert a new condition filter.

   - Edite el nuevo filtro de condición insertado para que coincida con la capacidad que quiere.

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

     ### Capacidades gestionadas

     Muestra la lista de capacidades gestionadas.

     Podrá seleccionar aquí una capacidad nueva únicamente si no está definida ya como un filtro de esquema.

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

2. Indica si esta es una condición «debe cumplir todas de» o «no debe cumplir ninguna de».

   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).

De manera predeterminada, la lista de condiciones basadas en capacidades está vacía. Esto significa que las capacidades no son relevantes para esta acción.

## Condición de cantidad de selección

Puede definir que su acción aparezca únicamente si la selección actual en el gestor de archivos tiene una cantidad precisa, o alguna relación precisa con una cantidad dada.

### Un caso de uso de cantidad de selección

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.

### Condiciones basadas en el entorno

Muestra la pestaña que le permite definir sus condiciones basadas en el entorno. Esto incluye la configuración de cantidad de selección, la selección de escritorios y los filtros de tiempo de ejecución.

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

### Cuadro de condición de cantidad de selección

Focus on the Appears if selection contains frame.

Cuando el objetivo sea el menú contextual de la selección, la condición de cantidad definida aquí se comparará con la cantidad de elementos actualmente seleccionados. Cuando el objetivo sea el menú contextual del lugar o la barra de herramientas, la condición de cantidad se comparará con cero porque no hay elementos seleccionados en este caso.

Para definir una condición de cantidad de selección:

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

  - `<` (estrictamente menor que)
  - `=` (igual a)
  - `>` (estrictamente mayor que)

- Introduzca la cantidad de referencia que quiera.

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.

## Selección de escritorios

Debe definir que su acción:

- aparecerá siempre,

- o aparecerá sólo en algunos entornos de escritorio,

- o no aparecerá en algunos entornos de escritorio.

Sólo es posible elegir uno de estos tres elementos.

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.

### Cuadro de selección de escritorios

Focus on the Desktop environment frame.

Para definir la condición del entorno de escritorio:

1. Primero seleccione el tipo de filtro:

   - ¿quiere que su acción aparezca siempre, sin importar el entorno de escritorio?
   - ¿quiere que su acción aparezca sólo en algún entorno de escritorio?
   - ¿quiere que su acción no aparezca nunca en algún entorno de escritorio?

2. Si no quiere que su acción aparezca siempre, seleccione el entorno de escritorio relevante en la lista desplegable del lado derecho.

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.

## Condición de ejecutable encontrado

Puede definir que su acción aparezca sólo si hay instalado algún paquete requerido en su sistema. Esto se verifica aquí mediante la especificación de un archivo particular, que sepa o suponga que el paquete proporciona, que debe estar presente en el sistema de archivos y ser ejecutable.

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.

### Cuadro de entorno de ejecución

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.

Deje el campo vacío si esta condición no es relevante para su acción.

Puede empotrar parámetros en el nombre de archivo buscado. Estos parámetros se reemplazarán dinámicamente en tiempo de ejecución con valores que dependerán de los elementos seleccionados actualmente.

## Condición de registro D-Bus

Puede definir que su acción aparezca sólo si algún nombre dado está registrado en el sistema D-Bus en tiempo de ejecución.

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.

Deje el campo vacío si esta condición no es relevante para su acción.

Puede empotrar parámetros en el nombre buscado. Se reemplazarán estos parámetros dinámicamente en tiempo de ejecución con valores que dependerán de los elementos seleccionados actualmente.

## Condición personalizada

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.

Deje el campo vacío si esta condición no es relevante para su acción.

Puede empotrar parámetros en el nombre de archivo ejecutado o en sus opciones. Estos parámetros se reemplazarán dinámicamente en tiempo de ejecución con valores que dependerán de los elementos seleccionados actualmente.

## Condición de procesos en ejecución

Puede definir que su acción aparezca únicamente si algún binario dado está en ejecución actualmente.

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.

Incluso si introduce aquí el nombre de archivo completo de un binario, sólo se buscará su nombre base en la lista de procesos en tiempo de ejecución.

Deje el campo vacío si esta condición no es relevante para su acción.

Puede empotrar parámetros en el nombre buscado. Se reemplazarán estos parámetros dinámicamente en tiempo de ejecución con valores que dependerán de los elementos seleccionados actualmente.