<?xml version="1.0" encoding="utf-8"?>
<sect2 id="usage-where">
  <title>Encontrar la acción</title>
    <figure id="cact-FIG-target-location-where">
      <title>Configuración del objetivo</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-target-location.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Muestra los tres campos que le permiten configurar el objetivo de su acción.</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>El objetivo es el menú contextual de la selección</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>Este objetivo está marcado de manera predeterminada.</para>
  </sect3>

  <sect3 id="usage-where-location">
    <title>El objetivo es el menú contextual del lugar</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>El objetivo es la barra de herramientas</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>Las acciones mostradas en la barra de herramientas sólo se refieren al lugar actual del gestor de archivos, no con los posibles elementos seleccionados. Para que su acción aparezca, el lugar actual debe cumplir todas las condiciones definidas en su acción candidata.</para>
  </sect3>

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

    <formalpara>
      <title>Si su acción se mostrará en un menú contextual</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>Dependiendo de la configuración exacta de su entorno de escritorio, se podrá o no mostrar el icono frente a la etiqueta en el menú.</para>
    </note>
    <tip>
      <para>Puede empotrar algunos parámetros en la etiqueta, el nombre del icono o el consejo. Estos parámetros se sustituirán dinámicamente en tiempo de ejecución con valores que dependerán de los elementos actualmente seleccionados.</para>
    </tip>

    <formalpara>
      <title>Si su acción se mostrará en la barra de herramientas</title>
      <para>Se mostrará como</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>Dependiendo de la configuración exacta de su entorno de escritorio, se podrá o no mostrar la etiqueta de la barra de herramientas frente al icono en la barra de herramientas.</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>Puede empotrar algunos parámetros en la etiqueta de la barra de herramientas, el nombre del icono o el consejo. Estos parámetros se sustituirán dinámicamente en tiempo de ejecución con valores que dependerán de los elementos actualmente seleccionados.</para>
    </tip>

    <formalpara>
      <title>Definir varios objetivos</title>
      <para>El objetivo de una acción puede ser el menú contextual de la selección, el menú contextual del lugar y la barra de herramientas, o uno o más de estos.</para>
    </formalpara>

    <formalpara>
      <title>No definir ningún objetivo</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>
