# Starting Caja-Actions Configuration Tool

You can start Caja-Actions Configuration Tool in the following ways:

System menu

- Choose Preferences Look and Feel Caja-Actions Configuration Tool.

Línea de comandos

- To start Caja-Actions Configuration Tool from a command line, type the following command:

  ``caja-actions-config-tool``

  then press Return.

  Para ver las opciones de línea de comandos disponibles, escriba:

  ``caja-actions-config-tool` `--help-all``

  then press Return.

## La primera ejecución

When you start Caja-Actions Configuration Tool, the following window is displayed.

### Caja-Actions Configuration Tool Start Up Window

Shows Caja-Actions Configuration Tool main window. Contains menubar, toolbar, display area, an empty items list in the left, several disabled properties tabs, and statusbar.

The Caja-Actions Configuration Tool main window contains the following elements:

Barra de menú.

- The menus on the menubar contain all of the commands you need to use in Caja-Actions Configuration Tool.

  Hay atajos disponibles para algunos comandos:

  Ctrl N

- Crear una acción nueva.

Ctrl S

- Guardar las acciones modificadas y los menús.

Ctrl Q

- Salir de la aplicación.

Ctrl X

- Cortar la selección actual, dejándola en el portapapeles.

Ctrl C

- Copiar la selección al portapapeles.

Ctrl V

- Insertar el contenido del portapapeles antes del elemento actual.

Mayús Ctrl V

- Insertar el contenido del portapapeles como subelemento(s) del elemento actual

Eliminar

- Eliminar la selección actual.

F5

- Recargar las acciones y los menús.

F1

- Mostrar la ayuda.

Barra de herramientas.

- Several toolbars may be displayed below the menubar, depending of your choices in the View Toolbars submenu.

Lista de elementos.

- The list on the left of the main window contains all items, whether they are actions or menus, currently available for edition in Caja-Actions Configuration Tool.

  Los elementos se puede clasificar alfabéticamente de manera ascendente o descendente, o no clasificarse, organizándolos y administrándolos directamente el usuario.

  Los elementos no válidos se muestran en color rojo.

  Los elementos modificados se muestran en caracteres en cursiva.

Ordenar botones

- Tres botones le permiten conmutar entre de modos de ordenación.

Pestañas de propiedades.

- La parte derecha de la ventana principal mostrará todo lo necesario para definir cómo, cuándo y dónde se mostrarán las acciones y los menús.

  Acción/Menú

- Define in which Caja menus the item should appear, and how it will be displayed.

Comando

- Especifique qué comando quiere ejecutar, y qué parámetros quiere pasarle.

Ejecución

- Especifique como quiere ejecutar el comando.

Nombres base

- Define the basename filters the Caja selection must satisfy in order the action or menu be candidate for display.

Tipos MIME

- Define the mimetype filters the Caja selection must satisfy in order the action or menu be candidate for display.

Carpetas

- Define the folder filters the Caja selection must satisfy in order the action or menu be candidate for display.

Esquemas

- Define the scheme filters the Caja selection must satisfy in order the action or menu be candidate for display.

Prestaciones

- Define the capability filters the Caja selection must satisfy in order the action or menu be candidate for display.

Entorno

- Define some environment conditions the Caja selection must satisfy in order the action or menu be candidate for display.

Propiedades

- Mostrar las propiedades del elemento.

Barra de estado.

- La barra de estado muestra alguna información del estado actual de la fila seleccionada actualmente en la lista de elementos.

  Cuando no hay información relevante para mostrar, la barra de estado muestra la cuenta de menús, acciones y perfiles cargados.

  The « read-only » icon is displayed in the right of the statusbar when appropriate.

## Crear su primera acción

En este ejemplo, se va a mostrar una acción que muestre alguna información sobre la selección actual.

## Comprobando los prerrequisitos

This action will require MateDialog.

MateDialog is a program which will allow you to create a graphical user interface from a command-line.

Debe comprobar que este programa esté instalado en su sistema, por ejemplo escribiendo en una terminal el siguiente comando:

``matedialog``

then press Return.

## Crear la acción

To create a new action, choose Ctrl N File New action.

Se inserta una acción nueva en la lista de elementos y sus propiedades se muestran en las pestañas del panel derecho.

La etiqueta de la acción editada actualmente (ésta misma) se añade al nombre de la aplicación en la barra de título.

### Propiedades predeterminadas de una acción nueva

Muestra las propiedades predeterminadas de una acción nueva.

In the Items list, the new action is displayed in italic characters.

Las cursivas se utilizan como recordatorio de que el elemento aún no se ha guardado.

As another reminder that there is some pending modifications, an asterisk (« `*` ») comes to prefix the application name in the title bar.

## Calificar su acción nueva

Simplemente consiste en elegir cómo su acción se mostrará en el menú contextual del gestor de archivos.

- Enter `My first action` in the Context label entry box.

  The Context label entry box contains the label of the action as you want it to be displayed in the file manager context menu.

  The label is a mandatory property of your action. If it happens to be empty, then your action will be considered as invalid by Caja-Actions: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

- Enter `This will execute an action with some parameters` in the Tooltip entry box.

  The Tooltip entry box contains the text you want to be displayed as a short help to your action.

- Select in the Icon drop-down list.

  The Icon selection defines the icon which will be associated with your action in file manager context menus and in the toolbar.

  Tiene dos formas de elegir el icono asociado a su acción:

  - Click on the Icon drop-down list to select an icon.

  - Click on Browse to search for an image in the filesystem.

## Especificar el comando que ejecutar

Cuando se seleccione su acción en el menú contextual del gestor de archivos, este comando se ejecutará con los argumentos de su elección.

Click on the Command tab to show the page which will permit you to enter the command.

### Pestaña «Comando»

Muestra la pestaña «Comando». Esta pestaña contiene el nombre del perfil, el comando que se ejecutará con sus argumentos y la configuración de la carpeta de trabajo inicial.

- Enter `matedialog` in the Path entry box.

  The Path entry box defines the command which will be executed when you will select your action in the file manager context menu.

  Tiene dos formas de definir el comando que ejecutar:

  - Enter it in the Path entry box.

  - Click on Browse to select the executable file on the filesystem.

  If the command you enter does not have an absolute path, then it will be searched for in the `PATH` variable at execution time.

- Enter `--info --text='%c selected item(s): %U'` in the Parameters entry box.

  The Parameters contains the arguments which will be passed to your command when it will be executed. These arguments may embed parameters which will be expanded at runtime.

  If both Path and Parameters are empty, then this action will be considered as invalid: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

## Guardado

To save all pending modifications, choose Ctrl S File Save.

Caja automatically takes into account your new action, and displays it in its context menu.

### Your first action in the Caja context menu

Shows the first action in the Caja context menu.

Cliking of the item in the Caja context menu activates it, and executes the corresponding command.

### El resultado de la ejecución de su primera acción

Shows the result of the execution of your first action. This is MateDialog dialog box, displaying the URI of the selected item.