Customizing Form and Field Headers - ES: Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category: Tutorial]]


==Field Headers==
==Encabezados de Campo==
You can customize the headers for a form field by updating the magic data associated with the headers.  You can do this through the magic data browser, but the best way is to make the change in a module for your site or in your site configuration file.  Headers are at the magic data location:  /modules/forms/formClasses/'''$formClass'''/fields/'''$field'''/headers/'''$headerType'''
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'''


In your site or module configuration file, you can change the headers by adding the following lines:
En su sitio en su archivo de configuración de modulo, puede cambiar los encabezados al agregar las líneas siguientes:
<source lang="xml">
<source lang="xml">
<configuration name="custom_headers" path="/modules/forms/formClasses/$formClass/fields/$field/headers/$headerType" locale="en_US">
<configuration name="custom_headers" path="/modules/forms/formClasses/$formClass/fields/$field/headers/$headerType" locale="en_US">
Line 10: Line 9:
</configuration>
</configuration>
</source>
</source>
For example, to change the header of the region field in districts you can do this:
Por ejemplo, para cambiar el encabezado de campo de region en los distritos puede hacer esto:
<source lang="xml">
<source lang="xml">
<configuration name="region_header" path="/modules/forms/formClasses/iHRIS_District/fields/region/headers/default" locale="en_US">
<configuration name="region_header" path="/modules/forms/formClasses/iHRIS_District/fields/region/headers/default" locale="en_US">
Line 17: Line 16:
</source>
</source>


In most cases you'll use the "default" as the '''$headerType'''.  If you want to have multiple headers, then change the header type and in the template that is displaying your field set the '''$headerType''' as the value for the showhead attribute.
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.
<source lang="html4strict">
<source lang="html4strict">
<span type="form" name="$form:$field" showhead="$headerType"></span>
<span type="form" name="$form:$field" showhead="$headerType"></span>
</source>
</source>
Replace $form, $field and $headerType with the appropriate values for your template.  For example:
Reemplace $form, $field y $headerType con los valores apropiados para su plantilla.  Por ejemplo:
<source lang="html4strict">
<source lang="html4strict">
<span type="form" name="country:name" showhead="my_header"></span>
<span type="form" name="country:name" showhead="my_header"></span>
</source>
</source>


==Form Display Names==
==Nombres Mostrados de Formularios==
You may also want to change the display name associated with a form. You can do this by changing the magic data at /modules/forms/forms/'''$form'''/display.  You can make this change in your site or module configuration file.
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.


<source lang="xml">
<source lang="xml">
Line 34: Line 33:
</configuration>
</configuration>
</source>
</source>
For example, to change the display name for region to be State:
Por ejemplo, para cambiar el nombre mostrado de región para que sea Estado:
<source lang="xml">
<source lang="xml">
<configuration name="region_display" path="/modules/forms/forms/region/display" locale="en_US">
<configuration name="region_display" path="/modules/forms/forms/region/display" locale="en_US">
Line 41: Line 40:
</source>
</source>


Some templates (like lists.html) may refer to the name in the template directly. You'll also need to modify this template to use the name you wish when linking to editing the database list for that form.
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.


==Geography Example==
==Ejemplo de Geografía==
Here's a complete example that you can add to your site's [[Module Structure#Module Configuration File|configuration]] .xml file.  It will change the names of the levels of geography to be Country/State/Council/Town or City.  Country will stay the same, region will become State, district will become Council and county will be come Town or City.  You will need to change the '''<version>4.0.XXX</version>''' as appropriate (see [[Configuration (Magic) Data#<version> | versions]]).
Aquí hay un ejemplo completo que puede agregar al archivo [[Module Structure#Module Configuration File|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 [[Configuration (Magic) Data#<version> | versions]]).


<source lang="xml">
<source lang="xml">
Line 74: Line 73:
</source>
</source>


==Editing lists.html==
==Editar lists.html==
As mentioned above, some .html template files refer to the form's name directly and will need to be edited.  You will want to copy the existing lists.html from the iHRIS Manage (or iHRIS Qualify) module to the templates directory in your sites module. You will then edit this new copy. For example you may do:
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 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 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
  sudo gedit /var/lib/iHRIS/sites/'''my_site'''/templates/en_US
where you replace '''4.0.4''' with the appropriate version and '''my_site''' the name of the directory that your site is stored in.   
donde reemplace '''4.0.4''' con la version apropiada y '''my_site''' con el nombre del directorio donde está guardado su sitio.   


Once gedit appears, you will need to change the names of the forms. For example:
Una vez que gedit aparezca, tendrá que cambiar los nombres de los formularios. Por ejemplo:
<source lang='xml'>
<source lang='xml'>
   <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">County</a></li>
   <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">County</a></li>
</source>
</source>
becomes:
se convierte en:
<source lang='xml'>
<source lang='xml'>
  <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">Town or City</a></li>
  <li task="can_edit_database_list_county"><a href="lists?type=county&amp;field=district">Town or City</a></li>


</source>
</source>
[[Category:Tutorial]][[Category:Forms]][[Category:Review2013]]
[[Category:Fields]][[Category:Spanish]]

Latest revision as of 13:02, 18 November 2013

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: <source lang="xml"> <configuration name="custom_headers" path="/modules/forms/formClasses/$formClass/fields/$field/headers/$headerType" locale="en_US"> 

 <value>$newHeader</value>

</configuration> </source> Por ejemplo, para cambiar el encabezado de campo de region en los distritos puede hacer esto: <source lang="xml"> <configuration name="region_header" path="/modules/forms/formClasses/iHRIS_District/fields/region/headers/default" locale="en_US"> 

 <value>State</value>

</configuration> </source>

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. <source lang="html4strict"> </source> Reemplace $form, $field y $headerType con los valores apropiados para su plantilla. Por ejemplo: <source lang="html4strict"> </source>

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.

<source lang="xml"> <configuration name="form_display" path="/modules/forms/forms/$form/display" locale="en_US"> 

 <value>$newHeader</value>

</configuration> </source> Por ejemplo, para cambiar el nombre mostrado de región para que sea Estado: <source lang="xml"> <configuration name="region_display" path="/modules/forms/forms/region/display" locale="en_US"> 

 <value>State</value>

</configuration> </source>

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

<source lang="xml"> <configurationGroup name="forms_module" path="/modules/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>
 <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>

</source>

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: <source lang='xml'>

  • <a href="lists?type=county&field=district">County</a>

    • </source> se convierte en: <source lang='xml'>

  • <a href="lists?type=county&field=district">Town or City</a>

    • </source>

    Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Customizing_Form_and_Field_Headers_-_ES&oldid=53263"