<?xml version="1.0" encoding="utf-8"?>
<sect2 id="usage-where">
  <title>Emplacement de l'action</title>
    <figure id="cact-FIG-target-location-where">
      <title>Configuration de la cible</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-target-location.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche les trois champs qui vous permettent de cibler votre action.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  <para>
    <productname>Caja</productname> file manager may display your action in different places,
    depending on what you will request here, and if some item is currently
    selected (or not).
  </para>
  <para>
    <!-- i18n: "Action" is a UI label -->
    Click on the <guilabel>Action</guilabel> tab to show the page
    which will permit you to configure the locations your action
    targets.
  </para>

  <sect3 id="usage-where-selection">
    <title>Ciblage du menu contextuel de la sélection</title>
    <para>
      When <guilabel>Display item in selection context menu</guilabel>
      is checked, then your action will be a candidate to be displayed in 
      <productname>Caja</productname>' context menu as soon as at least one item is selected in 
      the file manager. Your action will so deal with currently selected
      item(s).In order to be
      actually displayed, all the conditions defined in
      your candidate action must be met by each item currently selected
      in the <productname>Caja</productname> file manager. 
    </para>
    <tip>
      <para>
        When an action targets the selection context menu, and is actually 
        displayed in <productname>Caja</productname>' context menu, then it is also displayed
        in <productname>Caja</productname>' <guimenu>Edit</guimenu> menu.
      </para>
    </tip>
    <para>Cette cible est cochée par défaut.</para>
  </sect3>

  <sect3 id="usage-where-location">
    <title>Ciblage du menu contextuel des emplacements</title>
    <para>
      When <guilabel>Display item in location context menu</guilabel> checkbox
      is activated, then your action will be a candidate to be displayed in 
      <productname>Caja</productname>' context menu when the file manager selection is empty.
      Your action will so deal with currently displayed location.
      In order to be
      actually displayed, all the conditions defined in
      your candidate action must be met by the location currently displayed
      in the <productname>Caja</productname> file manager. 
    </para>
    <tip>
      <para>
        When an action targets the location context menu, and is actually 
        displayed in <productname>Caja</productname>' context menu, then it is also displayed
        in <productname>Caja</productname>' <guimenu>File</guimenu> menu.
      </para>
    </tip>
  </sect3>

  <sect3 id="usage-where-toolbar">
    <title>Ciblage de la barre d'outils</title>
    <para>
      When <guilabel>Display item in the toolbar</guilabel> checkbox
      is activated, then your action will be a candidate to be displayed in 
      <productname>Caja</productname>' toolbar.
    </para>
    <para>Les actions affichées dans la barre d'outils ne s'accordent qu'avec l'emplacement présentement affiché dans le gestionnaire de fichiers et non avec les éléments qui pourraient être sélectionnés (ou pas). Pour être affichées, toutes les conditions relatives à l'action candidate doivent être respectées pour l'emplacement en cours.</para>
  </sect3>

  <sect3 id="usage-where-notes">
    <title>Notes</title>

    <formalpara>
      <title>Si l'action est à afficher dans un menu contextuel,</title>
      <para>
        Whether it is the selection context menu or the location
        context menu, and both in <productname>Caja</productname>' context menus and in 
        <guimenu>File</guimenu> or <guimenu>Edit</guimenu> menus, it
        will be displayed as
      </para>
    </formalpara>
    <itemizedlist>
      <listitem>
        <para>
          <!-- i18n: "Context label" is a UI label -->
          the <guilabel>Context label</guilabel> as a label,
        </para>
      </listitem>
      <listitem>
        <para>
          <!-- i18n: "Icon" is a UI label -->
          the <guilabel>Icon</guilabel>,
        </para>
      </listitem>
      <listitem>
        <para>
          these two properties being associated with the
          <!-- i18n: "Tooltip" is a UI label -->
          <guilabel>Tooltip</guilabel>.
        </para>
      </listitem>
    </itemizedlist>
    <note>
      <para>Selon la configuration exacte de votre environnement bureau, l'icône est ou n'est pas affichée devant l'étiquette dans les menus.</para>
    </note>
    <tip>
      <para>Vous pouvez incorporer des paramètres dans l'étiquette, le nom de l'icône ou dans le texte d'information. 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.</para>
    </tip>

    <formalpara>
      <title>Si l'action est à afficher dans la barre d'outils,</title>
      <para>elle est affichée</para>
    </formalpara>
    <itemizedlist>
      <listitem>
        <para>
          <!-- i18n: "Toolbar label" is a UI label -->
          the <guilabel>Toolbar label</guilabel> as a label,
        </para>
      </listitem>
      <listitem>
        <para>
          <!-- i18n: "Icon" is a UI label -->
          the <guilabel>Icon</guilabel>,
        </para>
      </listitem>
      <listitem>
        <para>
          these two properties being associated with the
          <!-- i18n: "Tooltip" is a UI label -->
          <guilabel>Tooltip</guilabel>.
        </para>
      </listitem>
    </itemizedlist>
    <note>
      <para>Selon l'exacte configuration de votre environnement bureau, l'étiquette de la barre d'outils peut être ou ne pas être affichée avec l'icône dans la barre d'outils.</para>
    </note>
    <tip>
      <para>
        The toolbar label defaults to the same label as
        those used in menus. By unchecking the
        <guilabel>Use same label for icon in the toolbar</guilabel>
        checkbox you can define a label specific to the
        toolbar, which is usually shorter that those defined for the
        menus.
      </para>
    </tip>
    <tip>
      <para>Vous pouvez incorporer des paramètres dans l'étiquette de la barre d'outils, le nom de l'icône ou dans le texte d'information de l'infobulle. 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.</para>
    </tip>

    <formalpara>
      <title>Définition de plusieurs cibles</title>
      <para>Une action peut cibler à la fois le menu contextuel de la sélection, le menu contextuel de l'emplacement et la barre d'outils ou bien un ou plus parmi ceux-ci.</para>
    </formalpara>

    <formalpara>
      <title>Définition d'aucune cible</title>
      <para>
        If no target is defined,
        <abbrev>i.e.</abbrev> if the three checkboxes are unchecked,
        then your action will never be displayed.
      </para>
    </formalpara>
  </sect3>
</sect2>
