Cookies help us deliver our services. By using our services, you agree to our use of cookies.
Views

Customizing Form and Field Headers - ES

From IHRIS Wiki

Jump to: navigation, search

Encabezados de Campo

Puede personalizar los encabezados de campo de un formulario de campo al actualizar los datos magic asociados con los encabezados. Puede hacer esto a través del navegado de datos magic, pero la mejor manera es hacer el cambio en un módulo para su sitio o en el archivo de configuración de su sitio. Los encabezados se encuentran en la localidad de datos magic: /modules/forms/formClasses/$formClass/fields/$field/headers/$headerType

En su sitio en su archivo de configuración de modulo, puede cambiar los encabezados al agregar las líneas siguientes:

<configuration name="custom_headers" path="/modules/forms/formClasses/$formClass/fields/$field/headers/$headerType" locale="en_US">
  <value>$newHeader</value>
</configuration>

Por ejemplo, para cambiar el encabezado de campo de region en los distritos puede hacer esto:

<configuration name="region_header" path="/modules/forms/formClasses/iHRIS_District/fields/region/headers/default" locale="en_US">
  <value>State</value>
</configuration>

En la mayoría de los casos utilizará el "default" como el $headerType. Si quiere tener múltiples encabezados, entonces cambie el tipo de encabezado y en la plantilla que muestra su campo ponga el $headerType como el valor para el atributo principal.

<span type="form" name="$form:$field" showhead="$headerType"></span>

Reemplace $form, $field y $headerType con los valores apropiados para su plantilla. Por ejemplo:

<span type="form" name="country:name" showhead="my_header"></span>

Nombres Mostrados de Formularios

También puede que quiera cambiar el nombre mostrado asociado con un formulario. Puede hacer esto cambiando los datos magic en /modules/forms/forms/$form/display. Puede hacer este cambio en su sitio o archivo de configuración de módulo.

<configuration name="form_display" path="/modules/forms/forms/$form/display" locale="en_US">
  <value>$newHeader</value>
</configuration>

Por ejemplo, para cambiar el nombre mostrado de región para que sea Estado:

<configuration name="region_display" path="/modules/forms/forms/region/display" locale="en_US">
  <value>State</value>
</configuration>

Algunas plantillas (como lists.html) se pueden hacer referencia al nombre en la plantilla directamente. También tendrá que modificar esta plantilla para usar el nombre que desea cuando vincule para la edición de las listas de la base de datos de ese formulario.

Ejemplo de Geografía

Aquí hay un ejemplo completo que puede agregar al archivo configuration .xml de su sitio. Cambiará los nombres de los niveles de geografía a Country/State/Council/Town or City. Country permanecerá igual, region se convertirá en State, district se convertirá en Council y county se convertirá en Town or City. Necesitará cambiar la <version>4.0.XXX</version> como sea apropiado (vea versions).

<configurationGroup name="forms_module" path="/modules/forms">
  <!-- Update display names for forms -->
  <version>4.0.XXX</version>
  <configurationGroup name="forms">
    <configuration name="region_display" path="region/display" locale="en_US">
      <value>State</value>
    </configuration>
    <configuration name="district_display" path="district/display" locale="en_US">
      <value>Council</value>
    </configuration>
    <configuration name="region_display" path="county/display" locale="en_US">
      <value>Town or City</value>
    </configuration>    
  </configurationGroup>
  <!-- Update field headers for formClasses -->
  <configurationGroup name="formClasses">
    <configuration name="district_region_header" path="iHRIS_District/fields/region/headers/default" locale="en_US">
      <value>State</value>
    </configuration>
    <configuration name="country_district_header" path="iHRIS_County/fields/district/headers/default" locale="en_US">
      <value>Council</value>
    </configuration>
  </configurationGroup>
</configurationGroup>

Editar lists.html

Como se mencionó anteriormente, algunos archivos de plantilla .html hacen referencia al nombre del formulario directamente y deberán editarse. Va a querer copiar las lists.html existentes del módulo iHRIS Manage (o iHRIS Qualify) al directorio de plantillas en el módulo de su sitio. Luego editará esta copia nueva. Por ejemplo:

sudo mkdir -p /var/lib/iHRIS/sites/my_site/templates/en_US
sudo cp /var/lib/iHRIS/lib/4.0.4/ihris-manage/templates/en_US/lists.html /var/lib/iHRIS/sites/my_site/templates/en_US
sudo gedit /var/lib/iHRIS/sites/my_site/templates/en_US

donde reemplace 4.0.4 con la version apropiada y my_site con el nombre del directorio donde está guardado su sitio.

Una vez que gedit aparezca, tendrá que cambiar los nombres de los formularios. Por ejemplo:

  <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">County</a></li>

se convierte en:

 <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">Town or City</a></li>