* [Home](help)
-Friendica uses [Smarty 3](http://www.smarty.net/) as PHP templating engine. The main templates are found in
+Friendica uses [Smarty 3](http://www.smarty.net/) as PHP templating engine.
+The main templates are found in
/view/templates
directory.
-To render a template use the function *get_markup_template* to load the template and *replace_macros* to replace the macros/variables in the just loaded template file.
+To render a template use the function *getMarkupTemplate* to load the template and *replaceMacros* to replace the macros/variables in the just loaded template file.
- $tpl = get_markup_template('install_settings.tpl');
- $o .= replace_macros($tpl, array( ... ));
+ $tpl = Renderer::getMarkupTemplate('install_settings.tpl');
+ $o .= Renderer::replaceMacros($tpl, array( ... ));
the array consists of an association of an identifier and the value for that identifier, i.e.
Form Templates
--------------
-To guarantee a consistent look and feel for input forms, i.e. in the settings sections, there are templates for the basic form fields. They are initialized with an array of data, depending on the tyle of the field.
+To guarantee a consistent look and feel for input forms, i.e. in the settings sections, there are templates for the basic form fields.
+They are initialized with an array of data, depending on the tyle of the field.
-All of these take an array for holding the values, i.e. for an one line text input field, which is required and should be used to type email addesses use something along
+All of these take an array holding the values, e.g. for a one line text input field, which is required and should be used to type email addesses use something along the lines of:
- '$adminmail' => array('adminmail', t('Site administrator email address'), $adminmail, t('Your account email address must match this in order to use the web admin panel.'), 'required', '', 'email'),
+ '$adminmail' => array('adminmail', DI::l10n()->t('Site administrator email address'), $adminmail, DI::l10n()->t('Your account email address must match this in order to use the web admin panel.'), 'required', '', 'email'),
To evaluate the input value, you can then use the $_POST array, more precisely the $_POST['adminemail'] variable.
### field_checkbox.tpl
-A checkbox. If the checkbox is checked its value is **1**. Field parameter:
+A checkbox.
+If the checkbox is checked its value is **1**.
+Field parameter:
0. Name of the checkbox,
1. Label for the checkbox,
### field_combobox.tpl
-A combobox, combining a pull down selection and a textual input field. Field parameter:
+A combobox, combining a pull down selection and a textual input field.
+Field parameter:
0. Name of the combobox,
1. Label for the combobox,
### field_custom.tpl
-A customizeable template to include a custom element in the form with the usual surroundings, Field parameter:
+A customizeable template to include a custom element in the form with the usual surroundings,
+Field parameter:
0. Name of the field,
1. Label for the field,
### field_input.tpl
-A single line input field for textual input. Field parameter:
+A single line input field for any type of input.
+Field parameter:
0. Name of the field,
1. Label for the input box,
2. Current value of the variable,
3. Help text for the input box,
-4. if set to "required" modern browser will check that this input box is filled when submitting the form,
+4. Should be set to the translation of "Required" to mark this field as required,
5. if set to "autofocus" modern browser will put the cursur into this box once the page is loaded,
-6. if set to "email" or "url" modern browser will check that the filled in value corresponds to an email address or URL.
+6. if set, it will be used for the input type, default is `text` (possible types: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#%3Cinput%3E_types).
### field_intcheckbox.tpl
-A checkbox (see above) but you can define the value of it. Field parameter:
+A checkbox (see above) but you can define the value of it.
+Field parameter:
0. Name of the checkbox,
1. Label for the checkbox,
### field_openid.tpl
-An input box (see above) but prepared for special CSS styling for openID input. Field parameter:
+An input box (see above) but prepared for special CSS styling for openID input.
+Field parameter:
0. Name of the field,
1. Label for the input box,
### field_password.tpl
-A single line input field (see above) for textual input. The characters typed in will not be shown by the browser. Field parameter:
+A single line input field (see above) for textual input.
+The characters typed in will not be shown by the browser.
+Field parameter:
0. Name of the field,
1. Label for the field,
2. Value for the field, e.g. the old password,
3. Help text for the input field,
-4. if set to "required" modern browser will check that this field is filled out,
+4. Should be set to the translation of "Required" to mark this field as required,
5. if set to "autofocus" modern browser will put the cursor automatically into this input field.
### field_radio.tpl
-A radio button. Field parameter:
+A radio button.
+Field parameter:
0. Name of the radio button,
1. Label for the radio button,
### field_richtext.tpl
-A multi-line input field for *rich* textual content. Field parameter:
+A multi-line input field for *rich* textual content.
+Field parameter:
0. Name of the input field,
1. Label for the input box,
### field_select.tpl
-A drop down selection box. Field parameter:
+A drop down selection box.
+Field parameter:
0. Name of the field,
1. Label of the selection box,
### field_select_raw.tpl
-A drop down selection box (see above) but you have to prepare the values yourself. Field parameter:
+A drop down selection box (see above) but you have to prepare the values yourself.
+Field parameter:
0. Name of the field,
1. Label of the selection box,
### field_textarea.tpl
-A multi-line input field for (plain) textual content. Field parameter:
+A multi-line input field for (plain) textual content.
+Field parameter:
0. Name of the input field,
1. Label for the input box,
2. Current text for the box,
-3. Help text for the input box.
-
-### field_yesno.tpl
-
-A button that has two states *yes* or *no*. Field parameter:
-
-0. Name of the input field,
-1. Label for the button,
-2. Current value,
-3. Help text for the button
-4. if set to an array of two values, these two will be used, otherwise "off" and "on".
+3. Help text for the input box,
+4. Should be set to the translation of "Required" to mark this field as required.
https://reisub.nsupdate.info/git / friendica.git / .git / blobdiff