For Custom List Fields: Added option to "re-rank" field ranks when adding/updating a field in the middle of the form

git-svn-id: svn://192.168.202.10@3366 3d104415-ff17-0410-8863-d5cf3c621b8a

agc_2-X/trunk/www/vicidial/help_documentation.txt

@@ -1,4 +1,4 @@
-# version: 20210304161701
+# version: 20210304204801
 users-user	User ID	<QXZ>This field is where you put the users ID number, can be up to 8 digits in length, Must be at least 2 characters in length.</QXZ>
 users-pass	Password	<QXZ>This field is where you put the users password. Must be at least 2 characters in length. A medium strength user password will be at least 10 characters in length, and a strong user password will be at least 20 characters in length and have letters as well as at least one number. It is recommended that you use a longer password if possible, stringing together several unrelated words with no spaces, and a number somewhere in the string. The maximum size of a password is 100 characters.</QXZ>
 users-force_change_password	Force Change Password	<QXZ>If this option is set to Y then the user will be prompted to change their password the next time they log in to the administration webpage or the agent screen. Default is N.</QXZ>
@@ -443,6 +443,7 @@ lists_fields-field_name	Field Name	<QXZ>This is the name of the field as it will
 lists_fields-field_description	Field Description	<QXZ>The description of this field as it will appear in the administration interface. This is an optional field with a maximum of 100 characters.</QXZ>
 lists_fields-field_rank	Field Rank	<QXZ>The order in which these fields is displayed to the agent from lowest on top to highest on the bottom.</QXZ>
 lists_fields-field_order	Field Order	<QXZ>If more than one field has the same rank, they will be placed on the same line and they will be placed in order by this value from lowest to highest, left to right.</QXZ>
+lists_fields-field_rerank	Re-Rank Fields Below	<QXZ>If set to YES, this option will move existing other fields of an equal or lower rank down on the form by one place. Default is NO.</QXZ>
 lists_fields-field_help	Field Help	<QXZ>Optional field, if you fill it in, the agent will be able to see this text when they click on a help link next to the field in their agent interface.</QXZ>
 lists_fields-field_type	Field Type	<QXZ>This option defines the type of field that will be displayed. TEXT is a standard single-line entry form, AREA is a multi-line text box, SELECT is a single-selection pull-down menu, MULTI is a multiple-select box, RADIO is a list of radio buttons where only one option can be selected, CHECKBOX is a list of checkboxes where multiple options can be selected, DATE is a year month day calendar popup where the agent can select the date and TIME is a time selection box. The default is TEXT. For the SELECT, MULTI, RADIO and CHECKBOX options you must define the option values below in the Field Options box. DISPLAY will display only and not allow for modification by the agent. SCRIPT will also display only, but you are able to use script variables just like in the Scripts feature. SCRIPT fields will also only display the content in the Options, and not the field name like the DISPLAY type does. HIDDEN will not show the agent the field, but will allow the field to have data imported into it and exported from it, as well as have it available to the script tab and web form address. READONLY will display the value of the data in the field, but will not allow the agent to alter the data. HIDEBLOB is similar to HIDDEN except the data storage type on the database is a BLOB type, suitable for binary data or data that needs to be secured. The SWITCH field type allows the agent to switch the lead custom fields to another list, as well as reloading the FORM tab with the new set of list custom fields for the new list. To configure SWITCH type fields, you must define the button values below in the Field Options box. SOURCESELECT is a single-selection pull-down menu where there are multiple sets of options available depending on the value of another field for the lead, see the Field Options help for more details.</QXZ>
 lists_fields-field_options	Field Options	<QXZ>For the SELECT, MULTI, RADIO and CHECKBOX field types, you must define the option values in this box. You must put a list of comma separated option label and option text here with each option one its own line. The first value should have no spaces in it, and neither values should have any punctuation. For example - electric_meter, Electric Meter</QXZ>. <QXZ>For the SCRIPT field types, this field is where you put your script contents. You can use single quote and amphersand characters as well so that you can create links and iframe elements. If you want to put urlencoded fields in this area, make sure you use the --U-- and --V-- flags for your variables instead of using A and B, for example --U--test_field--V--. You can also use the --M-- and --N-- flags to enclose basic Math equations to have them calculated when the script is loaded initially, for example multiplying test_field by 12 would be entered with --M--(--A--test_field--B-- * 12)--N--. For the SWITCH field type, you should define the list ID for the custom fields as well as the text that you want to appear in the button to activate the new form in a comma separated line, with one line for each button you want to appear. For the SWITCH field type, it is a requirement that one of the entries be the current list ID. For SOURCESELECT, if this field is set to use the -province- field to determine what values to use, then the first line in the Field Options box should be -source=>province-, without the dashes. The next options line will be the first province value to look for, for example -value=>Ontario-, and if the value for that field for the lead matches, the next lines will be the options to show with the value and display text separated by a pipe. After that, you can add more values each with options after them, like this example below shows: <br>source=>province<br>value=>Ontario<br>option=>|select month here<br>option=>September|September<br>option=>October|October<br>value=>Nova Scotia<br>option=>|select month here<br>option=>June|June<br>option=>July|July<br>option=>August|August<br>value=>British Columbia<br>option=>|select month here<br>option=>January|January<br>option=>February|February<br>option=>March|March<br>value=><br>option=>|no match</QXZ>