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

Ligne de commande

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

  ``caja-actions-config-tool``

  then press Return.

  Pour afficher toutes les options disponibles en ligne de commande, saisissez :

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

  then press Return.

## Le premier lancement

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:

Une barre de menus.

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

  Des raccourcis clavier sont disponibles pour certaines commandes :

  Ctrl N

- Créer une nouvelle action.

Ctrl S

- Enregistrer les actions et les menus modifiés.

Ctrl Q

- Quitter l'application.

Ctrl X

- Couper la sélection en cours tout en la gardant dans le presse-papier.

Ctrl C

- Copier la sélection en cours dans le presse-papier.

Ctrl V

- Insérer le contenu du presse-papier devant l'élément sélectionné.

Maj Ctrl V

- Insérer le contenu du presse-papier en tant que sous-élement de l'élément sélectionné.

Suppr.

- Supprimer la sélection actuelle.

F5

- Recharger les actions et les menus.

F1

- Afficher l'aide.

Une barre d'outils.

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

Une liste d'éléments.

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

  Les éléments peuvent être triés dans l'ordre alphabétique naturel ou inverse. Ils peuvent également être gérés et organisés par l'utilisateur sans tri particulier.

  Les éléments non-valides sont affichés en rouge.

  Les éléments modifiés sont affichés en italiques.

Des boutons de tri.

- Trois boutons permettent de choisir le mode de tri.

Des onglets de propriétés.

- La partie droite de la fenêtre principale affiche tout ce qui est nécessaire pour définir comment, quand et où actions et menus sont affichés.

  Action/Menu

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

Commande

- Définit la commande à exécuter et quels paramètres lui transmettre.

Exécution

- Définit comment votre commande est exécutée.

Noms de base

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

Types MIME

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

Dossiers

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

Protocoles

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

Attributs

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

Environnement

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

Propriétés

- Affiche les propriétés des éléments.

Une barre d'état.

- Cette barre affiche des informations d'état à propos de l'élément sur la ligne actuellement sélectionnée dans la liste des éléments.

  Quand il n'y a aucune information pertinente à afficher, la barre d'état affiche le décompte des menus, actions ou profils chargés.

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

## Création de votre première action

Dans cet exemple, nous allons créer une action qui affiche des informations intéressantes à propos de la sélection actuelle.

## Vérification des prérequis

This action will require MateDialog.

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

Il faut vérifier que ce programme est installé sur le système ; par exemple, saisissez dans un terminal la commande suivante :

``matedialog``

then press Return.

## Création de l'action

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

Une nouvelle action s'insère dans la liste des éléments et ses propriétés sont affichées dans les onglets du panneau de droite.

L'étiquette de l'action en cours de création ou de modification (uniquement celle-ci) est apposée au nom de l'application sur la barre titre.

### Propriétés par défaut d'une nouvelle action

Affiche les propriétés par défaut d'une action nouvellement créée.

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

La graphie italique est utilisée pour rappeler que l'élément n'a pas été enregistré.

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

## Qualification de la nouvelle action

Cela consiste essentiellement à choisir quel sera l'intitulé de l'action dans le menu contextuel du gestionnaire de fichiers.

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

  Il y a deux manières de choisir l'icône associée à l'action :

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

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

## Définition de la commande à exécuter

Quand vous sélectionnez l'action dans le menu contextuel du gestionnaire de fichiers, cette commande est exécutée avec les paramètres de votre choix.

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

### Onglet Commande

Affiche l'onglet Commande. Cet onglet renferme le nom du profil, la commande à exécuter suivie de ses paramètres et la configuration du répertoire de travail de départ.

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

  Il y a deux façons de définir la commande à exécuter :

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

## Enregistrement

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.

### Le résultat de l'exécution de « Ma première action »

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