Technical Documentation
| ID | Category | Req. | Element | Action |
|---|---|---|---|---|
| 6 | array | yes | $zz Description of database table and fields | Show |
| 353 | string | no | $zz['access'] allows to restrict access to main record, like $zz['fields'][n]['access'] to subtables
* add_only: only allow to add record, do not show anything else (add new record-link, list table, ...)
* edit_only: only allow to edit record, do not show anything else (add new record-link, list table, ...)
* show: only view records
* show_edit_add (no deletion possible)
* show_and_add (no deletion and editing possible, but adding new records)
* show_and_delete
* add_then_edit: only allow to add a new record, then to reedit this record if it already exists (only works with GET['where']...)
* edit_details_only: do not edit main record, allow only detail records to be edited, no deletion and adding possible
* edit_details_and_add: do not edit main record, allow only detail records to be edited, adding possible (works only in combination with conditions)
* none: only show list, no possibility to do anything with the records
* all: allows to do everything
* search_but_no_list: shows search form but no list (search form normally is tied to list), no editing allowed Relations: $zz['fields'][n]['access'] | Show |
| 954 | boolean | no | $zz['add_from_source_id'] Allows to add from source_id even if the access to that ID is restricted by a $zz['where'] or $_GET['where'] | Show |
| 751 | array | no | $zz['conditional_fields'] | Show |
| 752 | array | no | $zz['conditional_fields'][n] | Show |
| 759 | array | no | $zz['conditional_fields'][n]['fi Relations: $zz['fields'][n] | Show |
| 758 | string | no | $zz['conditional_fields'][n]['ma | Show |
| 754 | boolean | no | $zz['conditional_fields'][n]['re | Show |
| 757 | string: SQL | no | $zz['conditional_fields'][n]['sq | Show |
| 756 | string | no | $zz['conditional_fields'][n]['ta | Show |
| 753 | integer | no | $zz['conditional_fields'][n]['te | Show |
| 755 | string | no | $zz['conditional_fields'][n]['ti | Show |
| 204 | array | no | $zz['conditions'] Numerical indexed array of conditions | Show |
| 798 | boolean | no | $zz['conditions'][n]['add']['alw | Show |
| 207 | string: field | no | $zz['conditions'][n]['add']['key Relations: $zz['conditions'][n]['add']['sql | Show |
| 206 | string: SQL | no | $zz['conditions'][n]['add']['sql Relations: $zz['conditions'][n]['add']['key | Show |
| 910 | boolean | no | $zz['conditions'][n]['add']['whe Relations: $zz['conditions'][n]['where'] | Show |
| 212 | string: field | no | $zz['conditions'][n]['field_name | Show |
| 815 | string: function | no | $zz['conditions'][n]['function'] | Show |
| 211 | string: SQL | no | $zz['conditions'][n]['having'] | Show |
| 203 | string | no | $zz['conditions'][n]['scope'] * record: with 'having' or 'where'; add['sql'], add['key_field_name'] * query: with 'sql' and 'key_field_name' * value: with 'sql' and 'field_name' * access: with 'function' and custom fields * upload (thought of, not yet implemented) * where: with 'field_name', triggers if a WHERE is set in the query for this field_name (shortcut in fields definition possible) * multi: if script is called via zzform_multi() * subrecord: with subrecord and where * noid: if an ID is so far not set (add before insert) * editing: checks where and POST value for a given field_name and if the adjoining query returns true, the condition is met (useful for adding/changing records, where a condition depends on a field value) | Show |
| 208 | string: SQL | no | $zz['conditions'][n]['sql'] | Show |
| 209 | string: field | no | $zz['conditions'][n]['key_field_ | Show |
| 943 | integer | no | $zz['conditions'][n]['subrecord' | Show |
| 205 | string: SQL | no | $zz['conditions'][n]['where'] | Show |
| 948 | boolean | no | $zz['dont_show_h1'] if set to true, h1 will not be shown | Show |
| 235 | array: path | no | $zz['dynamic_referer'] referer which links back to previous page, overwrites $zz_conf['referer'] and must be array with field1, string1 etc. Relations: $zz['fields'][n]['path']; $zz_conf['referer'] | Show |
| 242 | string | no | $zz['extra_action'] action to be performed after or before insert, update, delete
array values: `before_update`, `before_insert`, `before_delete`, `after_update`, `after_insert`, `after_delete`, `upload`
value: file to be included without ending ".inc.php"; alternatively this might also be the name of an existing function
if you do insert/update/delete queries, you might want to add them to the logging table with zz_log_sql($sql, $user, $record_id); ($sql being the query, $user the username) Relations: ACTION | Show |
| 10 | array | yes | $zz['fields'][n] Description of all table fields which shall be shown to edit a record or in list display (array). 'n' is a number and may be chosen freely (no order required). First field definition must be PRIMARY_KEY For the display order in form and list view, the order in the code is important, not the order of the numbers | Show |
| 354 | string | no | $zz['fields'][n]['access'] access on record basis
`show`: makes a subrecord not editable, just viewable Relations: $zz['access'] | Show |
| 983 | boolean | no | $zz['fields'][n]['add_details_de Relations: $zz['fields'][n]['add_details'] | Show |
| 420 | string | no | $zz['fields'][n]['add_details'] add detail records in different table, attention: current input will not be saved. Field gets ID #zz_add_details_x_y_z where x is table no [0...n], y is for subtable no [0 if main table, else 0...n] z is field number in zz-array Relations: select | Show |
| 437 | string: HTML | no | $zz['fields'][n]['add_details_ta | Show |
| 866 | boolean | no | $zz['fields'][n]['always_check_s | Show |
| 409 | string | no | $zz['fields'][n]['auto_value'] increment | ... // 1 will be added and inserted in 'default' Relations: number | Show |
| 430 | array | no | $zz['fields'][n]['calculation_fi Relations: calculated | Show |
| 431 | string | no | $zz['fields'][n]['calculation'] hours | sum (only supported modes) Relations: calculated | Show |
| 919 | string | no | $zz['fields'][n]['character_set' | Show |
| 199 | string: HTML | no | $zz['fields'][n]['class_add'] class name that will be shown if a subrecord will be added Relations: subtable | Show |
| 176 | string: HTML | no | $zz['fields'][n]['class'] class="" (some classes will be added by zzform, e. g. idrow, ...) | Show |
| 411 | integer | no | $zz['fields'][n]['cols'] number of cols in textarea Relations: memo | Show |
| 870 | string | no | $zz['fields'][n]['concat_0'] strings to format fields from sql query; sprintf will be used on these to insert the field value Relations: $zz['fields'][n]['sql']; select; $zz['fields'][n]['concat_fields' | Show |
| 869 | string | no | $zz['fields'][n]['concat_fields' Relations: $zz['fields'][n]['sql']; select | Show |
| 357 | array | no | $zz['fields'][n]['conf_identifie | Show |
| 358 | string | no | $zz['fields'][n]['conf_identifie | Show |
| 902 | array | no | $zz['fields'][n]['conf_identifie | Show |
| 1001 | string | no | $zz['fields'][n]['conf_identifie | Show |
| 829 | string: function | no | $zz['fields'][n]['conf_identifie | Show |
| 360 | string | no | $zz['fields'][n]['conf_identifie | Show |
| 359 | string | no | $zz['fields'][n]['conf_identifie | Show |
| 963 | string: function | no | $zz['fields'][n]['conf_identifie Relations: $zz['fields'][n]['conf_identifie | Show |
| 962 | string: function | no | $zz['fields'][n]['conf_identifie | Show |
| 828 | array | no | $zz['fields'][n]['conf_identifie Relations: $zz['fields'][n]['fields'] | Show |
| 827 | array | no | $zz['fields'][n]['conf_identifie Relations: $zz['fields'][n]['fields'] | Show |
| 361 | boolean | no | $zz['fields'][n]['conf_identifie | Show |
| 880 | integer | no | $zz['fields'][n]['conf_identifie | Show |
| 470 | string | no | $zz['fields'][n]['conf_identifie | Show |
| 891 | array | no | $zz['fields'][n]['conf_identifie Relations: identifier | Show |
| 362 | boolean | no | $zz['fields'][n]['conf_identifie | Show |
| 469 | boolean | no | $zz['fields'][n]['conf_identifie | Show |
| 468 | integer | no | $zz['fields'][n]['conf_identifie | Show |
| 972 | string: SQL | no | $zz['fields'][n]['conf_identifie Relations: $zz['fields'][n]['conf_identifie | Show |
| 363 | string: SQL | no | $zz['fields'][n]['conf_identifie | Show |
| 860 | integer | no | $zz['fields'][n]['decrease_level Relations: $zz['list']['hierarchy']['displa | Show |
| 466 | boolean | no | $zz['fields'][n]['def_val_ignore Relations: subtable | Show |
| 278 | mixed | no | $zz['fields'][n]['default_image' | Show |
| 639 | boolean | no | $zz['fields'][n]['default_select Relations: select | Show |
| 432 | variable | no | $zz['fields'][n]['default'] default value for field, normally string; for subrecords displayed as 'set' it may be an array as well | Show |
| 1008 | string: field | no | $zz['fields'][n]['dependent_on_a | Show |
| 1009 | string: field | no | $zz['fields'][n]['dependent_on_a Relations: $zz['fields'][n]['dependent_on_a | Show |
| 428 | integer | no | $zz['fields'][n]['detail_key_ind | Show |
| 426 | integer | no | $zz['fields'][n]['detail_value'] | Show |
| 649 | array | no | $zz['fields'][n]['disabled_ids'] Relations: select | Show |
| 1000 | array | no | $zz['fields'][n]['disabled'] List of IDs for radio buttons that are disabled for some reason | Show |
| 889 | string | no | $zz['fields'][n]['display_empty' Relations: display | Show |
| 182 | string: field | no | $zz['fields'][n]['display_field' Relations: select; write_once; display | Show |
| 830 | array | no | $zz['fields'][n]['display_title' Relations: display | Show |
| 401 | string | no | $zz['fields'][n]['display_value' Relations: write_once; display | Show |
| 716 | boolean | no | $zz['fields'][n]['dont_check_on_ | Show |
| 966 | boolean | no | $zz['fields'][n]['dont_copy'] do not copy contents of this field if copying a record Relations: $zz_conf['copy'] | Show |
| 500 | boolean | no | $zz['fields'][n]['dont_delete_re Relations: subtable | Show |
| 748 | boolean | no | $zz['fields'][n]['dont_mark_sear | Show |
| 970 | boolean | no | $zz['fields'][n]['dont_require_o Relations: password_change | Show |
| 424 | boolean | no | $zz['fields'][n]['dont_show_file | Show |
| 191 | boolean | no | $zz['fields'][n]['dont_show_imag | Show |
| 995 | boolean | no | $zz['fields'][n]['dont_show_miss Relations: $zz['fields'][n]['dont_show_miss | Show |
| 710 | boolean | no | $zz['fields'][n]['dont_show_miss | Show |
| 849 | boolean | no | $zz['fields'][n]['dont_sort'] if set to true, no ordering in this column is allowed; 'id'-columns are set to true by default, if you'd like to order by id, you have to set them to false explicitly | Show |
| 938 | boolean | no | $zz['fields'][n]['dont_trim'] if set to true, 'text' fields won't be trimmed Relations: text | Show |
| 996 | boolean | no | $zz['fields'][n]['enum_textinput Relations: select; $zz['fields'][n]['enum'] | Show |
| 397 | array | no | $zz['fields'][n]['enum_title'] Optional. In case you don't like your ENUM values, you can set an array with different values that will be shown instead the values in the database. Good for translations. Relations: select; $zz['fields'][n]['enum'] | Show |
| 396 | array | no | $zz['fields'][n]['enum'] list for enum, default value with 'default' should be set as well Relations: $zz['fields'][n]['show_values_as | Show |
| 844 | array | no | $zz['fields'][n]['enum_abbr'] List of abbreviations for enum, in list view, abbreviation will be shown in form view and displayed as abbr-element in list view Relations: select | Show |
| 969 | string: HTML | no | $zz['fields'][n]['error_msg'] Show individual error message if validation failed instead of generic message | Show |
| 388 | boolean | no | $zz['fields'][n]['exclude_from_s | Show |
| 474 | string: HTML | no | $zz['fields'][n]['explanation_to Relations: $zz['fields'][n]['explanation'] | Show |
| 475 | string: HTML | no | $zz['fields'][n]['explanation'] explanation how to fill in values in this field, will only be shown in edit or insert mode | Show |
| 643 | boolean | no | $zz['fields'][n]['export_no_html | Show |
| 786 | boolean | no | $zz['fields'][n]['export'] Exclude field from export | Show |
| 685 | string | no | $zz['fields'][n]['f_field_name'] Relations: $zz['fields'][n]['field_name'] | Show |
| 408 | integer | no | $zz['fields'][n]['factor'] factor for avoiding doubles as database fields Relations: number | Show |
| 11 | string: field | yes | $zz['fields'][n]['field_name'] Database field name; required, if field value shall be shown or changed in the output. Not all fields of a table have to be defined, the undefined fields will be ignored by the script. Relations: $zz['fields'][n] | Show |
| 994 | integer | no | $zz['fields'][n]['field_sequence | Show |
| 621 | array | no | $zz['fields'][n]['fielddefs'] In combination with 'values', 'fielddefs' allows to change some $zz['fields']-settings for individual detail records where values are preset.
The first numerical index of the field definition corresponds to the numerical index of the corresponding value, the second index corresponds to the field index that shall be changed. Relations: subtable; $zz['fields'][n]['values'] | Show |
| 364 | array | no | $zz['fields'][n]['fields'] List of fields which are used to create an identifier (`$zz['fields'][n]['type'] = 'identifier'`). If field_name of identifier-field is part of the array, the identifier won't be changed later on (write_once). Corresponding values of ID fields may be used writing `field_id[value]`. The fields are used in the same order as in the array.
vars which will be passed to function or identifier, might be in form like "select_id[field_name_from_selec | Show |
| 172 | string: field | no | $zz['fields'][n]['fields'][n]['d | Show |
| 847 | boolean | no | $zz['fields'][n]['for_action_ign Relations: $zz['fields'][n]['def_val_ignore | Show |
| 429 | string: field | no | $zz['fields'][n]['foreign_key_fi Relations: subtable | Show |
| 198 | string | no | $zz['fields'][n]['form_display'] Relations: select; subtable | Show |
| 35 | string: function | no | $zz['fields'][n]['format'] Formats in form view text content of field with this markup language (e. g. Markdown), function of the same name must lie inside zzform-folder Relations: text; memo | Show |
| 976 | integer | no | $zz['fields'][n]['formatting_spa | Show |
| 399 | string: function | no | $zz['fields'][n]['function'] function which will be called to change input value
`function($vars, $field_name);`
$vars = POST vars of fields defined in an array in $zz['fields'][n]['fields']
$fie Relations: hidden | Show |
| 810 | string | no | $zz['fields'][n]['geo_display_be Relations: number | Show |
| 811 | string | no | $zz['fields'][n]['geo_format'] output of coordinate, possible values are dec, dms, deg, dm Relations: number | Show |
| 928 | string | no | $zz['fields'][n]['geocode_defaul Relations: $zz['fields'][n]['geocode'] | Show |
| 982 | array | no | $zz['fields'][n]['geocode_ignore Relations: $zz['fields'][n]['geocode'] | Show |
| 989 | boolean | no | $zz['fields'][n]['geocode_ignore Relations: $zz['fields'][n]['geocode'] | Show |
| 924 | string: SQL | no | $zz['fields'][n]['geocode_sql'] SQL query to replace ID value for geocoding with real content Relations: $zz['fields'][n]['geocode'] | Show |
| 923 | string | no | $zz['fields'][n]['geocode'] Mark fields for geocoding: 'postal_code', 'country', 'street', 'street_number', 'locality', 'latitude', 'longitude', 'state', 'place' 'place' is somewhat special. It adds a possibility to add the name of the place or venue if the full address is not known. In case 'place' + the rest of the address yields no results, a second query without 'place' is started | Show |
| 978 | mixed | no | $zz['fields'][n]['group_dependen Relations: $zz['fields'][n]['group_in_list' | Show |
| 523 | boolean | no | $zz['fields'][n]['group_in_list' Relations: LIST | Show |
| 546 | string: field | no | $zz['fields'][n]['group'] allows to group records select via HTML optgroup-element Relations: select | Show |
| 964 | boolean | no | $zz['fields'][n]['hide_auto_add_ | Show |
| 746 | boolean | no | $zz['fields'][n]['hide_format_in Relations: $zz['fields'][n]['format']; $zz['fields'][n]['title_desc'] | Show |
| 781 | boolean | no | $zz['fields'][n]['hide_in_form_a Relations: $zz['fields'][n]['hide_in_form'] | Show |
| 180 | boolean | no | $zz['fields'][n]['hide_in_form'] | Show |
| 959 | boolean | no | $zz['fields'][n]['hide_in_list_i Relations: $zz['fields'][n]['hide_in_list'] | Show |
| 179 | boolean | no | $zz['fields'][n]['hide_in_list'] | Show |
| 422 | boolean | no | $zz['fields'][n]['hide_novalue'] Relations: select | Show |
| 750 | boolean | no | $zz['fields'][n]['hide_zeros'] values 0 will be converted to '' (unit, prefix, suffix etc. will not be shown) | Show |
| 614 | string: field | no | $zz['fields'][n]['id_field_name' Relations: $zz['fields'][n]['sql']; select | Show |
| 185 | array | no | $zz['fields'][n]['if'][n] Field definitions which will be set if a certain condition n is met. For some conditions, shortcuts exist: - 'multi': if script is called via zzform_multi() - 'where': if field has id value which is defined by WHERE condition ($zz['where'], $_GET['where']) - 'add': if a record is added - 'delete': if a record is deleted - 'edit': if a record is edited - 'upload: if something is uploaded | Show |
| 192 | array | no | $zz['fields'][n]['image'] what has to be done with uploaded image. keys as follows. | Show |
| 450 | string: function | no | $zz['fields'][n]['image'][n]['ac | Show |
| 449 | integer | no | $zz['fields'][n]['image'][n]['au | Show |
| 448 | array | no | $zz['fields'][n]['image'][n]['au | Show |
| 447 | string: function | no | $zz['fields'][n]['image'][n]['au | Show |
| 937 | string | no | $zz['fields'][n]['image'][n]['co | Show |
| 442 | string: field | no | $zz['fields'][n]['image'][n]['fi | Show |
| 441 | integer | no | $zz['fields'][n]['image'][n]['he | Show |
| 451 | boolean | no | $zz['fields'][n]['image'][n]['ig | Show |
| 457 | array | no | $zz['fields'][n]['image'][n]['in | Show |
| 454 | integer | no | $zz['fields'][n]['image'][n]['ma | Show |
| 452 | integer | no | $zz['fields'][n]['image'][n]['ma | Show |
| 455 | integer | no | $zz['fields'][n]['image'][n]['mi | Show |
| 453 | integer | no | $zz['fields'][n]['image'][n]['mi | Show |
| 999 | boolean | no | $zz['fields'][n]['image'][n]['no | Show |
| 458 | boolean | no | $zz['fields'][n]['image'][n]['op | Show |
| 961 | string | no | $zz['fields'][n]['image'][n]['op Relations: $zz['fields'][n]['image'][n]['op | Show |
| 545 | string: SQL | no | $zz['fields'][n]['image'][n]['op Relations: $zz['fields'][n]['image'][n]['op | Show |
| 446 | array | no | $zz['fields'][n]['image'][n]['op Relations: option | Show |
| 444 | array: path | no | $zz['fields'][n]['image'][n]['pa | Show |
| 944 | array | no | $zz['fields'][n]['image'][n]['re | Show |
| 443 | boolean | no | $zz['fields'][n]['image'][n]['re | Show |
| 456 | boolean | no | $zz['fields'][n]['image'][n]['sh | Show |
| 193 | string: field | no | $zz['fields'][n]['image'][n]['so | Show |
| 195 | string: SQL | no | $zz['fields'][n]['image'][n]['so Relations: $zz['fields'][n]['image'][n]['so | Show |
| 194 | array: path | no | $zz['fields'][n]['image'][n]['so | Show |
| 445 | integer | no | $zz['fields'][n]['image'][n]['so | Show |
| 439 | string | no | $zz['fields'][n]['image'][n]['ti | Show |
| 196 | array | no | $zz['fields'][n]['image'][n]['up Relations: $zz['fields'][n]['image'][n]['up | Show |
| 197 | array | no | $zz['fields'][n]['image'][n]['up Relations: $zz['fields'][n]['image'][n]['up | Show |
| 440 | integer | no | $zz['fields'][n]['image'][n]['wi | Show |
| 956 | boolean | no | $zz['fields'][n]['import_id_valu Relations: id | Show |
| 392 | boolean | no | $zz['fields'][n]['in_sql_query'] | Show |
| 459 | boolean | no | $zz['fields'][n]['inherit_format Relations: $zz['fields'][n]['format'] | Show |
| 707 | boolean | no | $zz['fields'][n]['input_only'] field is for input only (e. g. if value will be used for different fields, or parts of it); something entered in this field won't be saved | Show |
| 868 | string | no | $zz['fields'][n]['js'] Adds JavaScript to 'explanation', e. g. 'select/deselect' adds JS for acitvating/deactivating all checkboxes Relations: $zz['fields'][n]['explanation'] | Show |
| 418 | string: field | no | $zz['fields'][n]['key_field_name Relations: select; foreign_key | Show |
| 842 | string | no | $zz['fields'][n]['kml'] item name in KML export, 'title', latitude' and 'longitude' (or alternatively 'point') must be set when KML export is active. 'altitude' is optional. 'description' will be put below all fields with title=> value in tabular format; 'style' will be used as ID for style element for this record | Show |
| 186 | array: path | no | $zz['fields'][n]['link'] Link in list view to record. May be array, then it works with field, mode and string (field1, field2, mode1, ...) see also: path. If root is set, link will be looked for in filesystem. if not existent, returns false (no link) Relations: $zz['fields'][n]['path'] | Show |
| 568 | string: HTML | no | $zz['fields'][n]['link_attribute | Show |
| 615 | boolean | no | $zz['fields'][n]['link_referer'] | Show |
| 433 | string: HTML | no | $zz['fields'][n]['link_target'] HTML target-attribute for link (`target="value"`) | Show |
| 434 | array: path | no | $zz['fields'][n]['link_title'] HTML title-attribute for link in list to record. May be array, then it works with field and string (field1, field2, string1, ...) see also: path Relations: $zz['fields'][n]['path'] | Show |
| 471 | string | no | $zz['fields'][n]['list_abbr'] name of field whose value will be displayed in <abbr title=""> behind displayed value | Show |
| 894 | string: HTML | no | $zz['fields'][n]['list_append_if Relations: $zz['fields'][n]['list_append_ne | Show |
| 895 | string: HTML | no | $zz['fields'][n]['list_append_if Relations: $zz['fields'][n]['list_append_ne | Show |
| 477 | boolean | no | $zz['fields'][n]['list_append_ne | Show |
| 822 | boolean | no | $zz['fields'][n]['list_append_sh Relations: $zz['fields'][n]['list_append_ne | Show |
| 855 | string: HTML | no | $zz['fields'][n]['list_concat_fi | Show |
| 425 | string: function | no | $zz['fields'][n]['list_format'] function which will be used to format text for display, e. g. markdown | textile, in list part; might be array if you want to use several functions Relations: $zz['fields'][n]['format']; text; memo | Show |
| 906 | string: function | no | $zz['fields'][n]['list_function' Relations: list_function | Show |
| 977 | boolean | no | $zz['fields'][n]['list_no_link'] | Show |
| 991 | string: HTML | no | $zz['fields'][n]['list_prefix_ap Relations: $zz['fields'][n]['list_prefix']; | Show |
| 356 | string: HTML | no | $zz['fields'][n]['list_prefix'] prefix in front of the field value in list view Relations: $zz['fields'][n]['list_suffix'] | Show |
| 992 | string: HTML | no | $zz['fields'][n]['list_suffix_ap Relations: $zz['fields'][n]['list_suffix']; | Show |
| 355 | string: HTML | no | $zz['fields'][n]['list_suffix'] suffix behind the field value in list view Relations: $zz['fields'][n]['list_prefix'] | Show |
| 967 | string: HTML | no | $zz['fields'][n]['list_unit'] displays a unit behind a number, won't display if value = NULL, list mode Relations: number; $zz['fields'][n]['unit'] | Show |
| 1007 | array | no | $zz['fields'][n]['mark_scope'] marks content in this field (most likely a field with 'display_field' set) if a search is done over one of the fields in the list of fields | Show |
| 190 | integer | no | $zz['fields'][n]['max_records'] Relations: subtable | Show |
| 940 | string: SQL | no | $zz['fields'][n]['max_records_sq Relations: subtable | Show |
| 460 | integer | no | $zz['fields'][n]['maxlength'] maxlength, if not set will be taken from database | Show |
| 953 | boolean | no | $zz['fields'][n]['merge_equal'] Records will only be merged if values in this field are equal Relations: $zz_conf['merge'] | Show |
| 952 | boolean | no | $zz['fields'][n]['merge_ignore'] Relations: $zz_conf['merge'] | Show |
| 714 | integer | no | $zz['fields'][n]['min_records_re Relations: $zz['fields'][n]['min_records']; | Show |
| 189 | integer | no | $zz['fields'][n]['min_records'] Relations: subtable | Show |
| 939 | string: SQL | no | $zz['fields'][n]['min_records_sq Relations: subtable | Show |
| 650 | string | no | $zz['fields'][n]['msg_no_subtabl | Show |
| 911 | boolean | no | $zz['fields'][n]['multiple_edit' Relations: $zz[list']['select_multiple_reco | Show |
| 436 | boolean | no | $zz['fields'][n]['null_string'] Field value might be 0 or '', won't be set to NULL => output = '' Relations: $zz['fields'][n]['null'] | Show |
| 435 | boolean | no | $zz['fields'][n]['null'] Field value might be 0 or '', won't be set to NULL => output = 0 Relations: $zz['fields'][n]['null_string'] | Show |
| 398 | string | no | $zz['fields'][n]['number_type'] - 'longitude' | 'latitude', for entering geo information
- 'currency' for money
- 'bytes' for bytes, for displaying MB, GB, TB etc.
- 'number' for numbers, formatted with thousands_separator and decimal_point Relations: number | Show |
| 427 | array | no | $zz['fields'][n]['options'] Together with enum-array; values from enum-array will have to be set as pairs. E. g. enum-value proportional will be an array in options, first is key which will be added to image, second is corresponding value: ['options'] = array('proportional' => array('key' => 'value')); existing keys will be overwritten | Show |
| 617 | string | no | $zz['fields'][n]['order'] different field name for ORDER BY, e. g. if a table name is needed in case of ambiguous field names or for mixed alpha-numerical strings without preceding zeros | Show |
| 648 | string | no | $zz['fields'][n]['path_json_base Relations: image; $zz['fields'][n]['path_json_requ | Show |
| 647 | array: path | no | $zz['fields'][n]['path_json_requ Relations: image | Show |
| 421 | string: SQL | no | $zz['fields'][n]['path_sql'] only if this sql query is needed for constructing the extension of a file path; sql-query which will be used if this field's display_value is set as fieldxx in path to get a correct extension for file conversions Relations: select | Show |
| 184 | array | no | $zz['fields'][n]['path'] values: - `root` DOCUMENT_ROOT or path to directory, will be used as a prefix to check whether file_exists or not - `webroot` alternative for DOCUMENT_ROOT on URL basis of the webserver - `fieldXX` will add corresponding field value, - `stringXX` will add string value, (string1 will be weblink to file, parallel to root) - `webstringXX` same as string, but applied only to web path, not to file path - `modeXX`: functions that will be applied to all field_values - last `stringXX` or `fieldXX`: this must consist of the fileextension only (with or without .) e. g. array('field1' => 'fieldname_bla', 'string1' => '/', 'field2' => 'fieldname_blubb') etc. - as an alternative, `extension` can be used instead of fieldXX - `x_field[2]XX` = similar to field, but for 2x image - `x_field[1.5]XX` = similar to field, but for 1.5x image - `x_extension[2]XX` = similar to extension, but for 2x image - `x_webfield[2]XX` = similar to webfield, but for 2x image | Show |
| 709 | string: function | no | $zz['fields'][n]['post_validatio Relations: $zz['fields'][n]['detail_value'] | Show |
| 464 | string: HTML | no | $zz['fields'][n]['prefix'] adds prefix-string to form view Relations: $zz['fields'][n]['suffix'] | Show |
| 616 | integer | no | $zz['fields'][n]['read_options'] Relations: option; $zz['fields'][n]['options'] | Show |
| 200 | boolean | no | $zz['fields'][n]['records_depend | Show |
| 986 | boolean | no | $zz['fields'][n]['remove_local_h | Show |
| 741 | array | no | $zz['fields'][n]['replace_values | Show |
| 618 | boolean | no | $zz['fields'][n]['required'] field requires an input (same behaviour as NOT NULL, but allow flexible table definition) | Show |
| 412 | integer | no | $zz['fields'][n]['rows_max'] max number of rows in textarea (textarea might expand if text is edited to approximately the numbers of rows needed to display all text without scroll bar) Relations: memo | Show |
| 202 | integer | no | $zz['fields'][n]['rows'] number of rows in textarea, will be expanded if a record is edited to approximately the needed length Relations: memo | Show |
| 802 | string: SQL | no | $zz['fields'][n]['search_between | Show |
| 619 | string: SQL | no | $zz['fields'][n]['search'] if a field does not appear without an alias or appears ambiguous in the SQL query for 'list' view, here you can define the exact field name or field combination that will be used for search | Show |
| 929 | mixed | no | $zz['fields'][n]['separator_befo Relations: $zz['fields'][n]['separator'] | Show |
| 465 | mixed | no | $zz['fields'][n]['separator'] - true: will put a separation behind this field, to improve form layout. - column_begin, column, column_end: put form in two columns - text bla blubb: will put bla blubb below `<hr>`-Separator | Show |
| 779 | string: filename | no | $zz['fields'][n]['set_folder'] path of folder, files in this folder will be presented for selection (no subfolders), names of chosen files will be saved in database. Relations: select | Show |
| 780 | boolean | no | $zz['fields'][n]['set_show_all_v Relations: select; $zz['fields'][n]['set_folder'] | Show |
| 640 | string: SQL | no | $zz['fields'][n]['set_sql'] similar to set, lets you get comma separated values from an SQL query that will be treated similar as a mysql SET field Relations: select | Show |
| 638 | array | no | $zz['fields'][n]['set_title'] similar to enum_title
in combination with set_sql: if = true, uses second field from sql-query as set_title Relations: select; $zz['fields'][n]['set'] | Show |
| 395 | array | no | $zz['fields'][n]['set'] array for set Relations: $zz['fields'][n]['show_values_as | Show |
| 782 | boolean | no | $zz['fields'][n]['show_hierarchy Relations: $zz['fields'][n]['show_hierarchy | Show |
| 416 | integer | no | $zz['fields'][n]['show_hierarchy Relations: select; $zz['fields'][n]['show_hierarchy | Show |
| 419 | boolean | no | $zz['fields'][n]['show_hierarchy Relations: select; $zz['fields'][n]['show_hierarchy | Show |
| 417 | string: field | no | $zz['fields'][n]['show_hierarchy Relations: select | Show |
| 386 | boolean | no | $zz['fields'][n]['show_id'] Normally, id fields get class record_id {display: none;}, show_id stops zzform from doing that Relations: id | Show |
| 178 | boolean | no | $zz['fields'][n]['show_title'] display record: show field title in TH (mainly for subtables, for aesthetic reasons) | Show |
| 298 | boolean | no | $zz['fields'][n]['show_values_as Relations: select; $zz['fields'][n]['set']; $zz['fields'][n]['enum'] | Show |
| 423 | integer | no | $zz['fields'][n]['size_select_to Relations: select | Show |
| 405 | integer | no | $zz['fields'][n]['size'] Maximum length of characters that may be entered in input field, size of input field, standard for number 16, for time 8 and for all other fields 32 (or maxlength if smaller) | Show |
| 872 | array | no | $zz['fields'][n]['sql_character_ Relations: $zz['fields'][n]['sql']; select | Show |
| 896 | array | no | $zz['fields'][n]['sql_fieldnames Relations: select | Show |
| 415 | array | no | $zz['fields'][n]['sql_ignore'] doesn't display fields of sql query in form view. this is useful if you need the fields for an identifier field; array, fields won't display in form view. Relations: $zz['fields'][n]['sql']; select | Show |
| 467 | boolean | no | $zz['fields'][n]['sql_index_only Relations: select | Show |
| 787 | string: SQL | no | $zz['fields'][n]['sql_not_unique | Show |
| 404 | string: SQL | no | $zz['fields'][n]['sql_password_c Relations: password_change | Show |
| 873 | array | no | $zz['fields'][n]['sql_table'] Table names of fields in SQL query if not included in this query (to get correct character set for reselect) Relations: $zz['fields'][n]['sql']; select | Show |
| 958 | array | no | $zz['fields'][n]['sql_translate' Relations: $zz['sql'] | Show |
| 623 | boolean | no | $zz['fields'][n]['sql_where_with | Show |
| 1002 | boolean | no | $zz['fields'][n]['sql_where_with | Show |
| 413 | array | no | $zz['fields'][n]['sql_where'] adds where to sql-string, rather complicated ... :-)
$zz['fields'][4]['sql_whe Relations: select | Show |
| 414 | boolean | no | $zz['fields'][n]['sql_without_id Relations: select | Show |
| 181 | string: SQL | no | $zz['fields'][n]['sql'] SQL-Query for select, first field is key field which will not be displayed but entered into database field Relations: select | Show |
| 946 | string: SQL | no | $zz['fields'][n]['sqlcount'] query which has to have something like `COUNT(record_id) AS record_id` in it to provide a faster alternative to querying several records up to max_select for counting all records available for a select field Relations: $zz['fields'][n]['sql']; $zz_conf['max_select'] | Show |
| 201 | string: SQL | no | $zz['fields'][n]['sqlorder'] | Show |
| 299 | array | no | $zz['fields'][n]['subselect'] Displays records of detail tables in list view, allows to search through these detail tables as well. Key 'sql' is required, rest is optional. | Show |
| 302 | string: HTML | no | $zz['fields'][n]['subselect']['c | Show |
| 301 | string: HTML | no | $zz['fields'][n]['subselect']['c | Show |
| 997 | boolean | no | $zz['fields'][n]['subselect']['c Relations: $zz['fields'][n]['subselect']['p | Show |
| 883 | string: HTML | no | $zz['fields'][n]['subselect']['f | Show |
| 884 | string: HTML | no | $zz['fields'][n]['subselect']['f | Show |
| 879 | array: path | no | $zz['fields'][n]['subselect']['l | Show |
| 300 | string: HTML | no | $zz['fields'][n]['subselect']['p | Show |
| 882 | boolean | no | $zz['fields'][n]['subselect']['s | Show |
| 973 | array | no | $zz['fields'][n]['subselect']['s Relations: $zz['fields'][n]['subselect']['s | Show |
| 438 | string: SQL | no | $zz['fields'][n]['subselect']['s | Show |
| 303 | string: HTML | no | $zz['fields'][n]['subselect']['s | Show |
| 788 | string: field | no | $zz['fields'][n]['subselect']['t | Show |
| 909 | string: function | no | $zz['fields'][n]['subselect']['l Relations: $zz['fields'][n]['subselect']['l | Show |
| 171 | string: function | no | $zz['fields'][n]['subselect']['l Relations: $zz['fields'][n]['list_format'] | Show |
| 461 | string: HTML | no | $zz['fields'][n]['suffix'] adds suffix-string to form view | Show |
| 462 | string: function | no | $zz['fields'][n]['suffix_functio | Show |
| 463 | array | no | $zz['fields'][n]['suffix_functio | Show |
| 188 | string: field | no | $zz['fields'][n]['table_name'] Alias if more subtables are included (used for search only, AFAIK) Relations: subtable | Show |
| 854 | string: field | no | $zz['fields'][n]['text_field'] similar to display_field, this key must be set to a field name from the SQL query which contains the textual representation of the corresponding spatial field Relations: geo_point | Show |
| 922 | string | no | $zz['fields'][n]['text_none_sele Relations: select; $zz['fields'][n]['hide_novalue'] | Show |
| 620 | boolean | no | $zz['fields'][n]['tick_to_save'] Relations: subtable | Show |
| 955 | string | no | $zz['fields'][n]['time_format'] allows to format a time with date() Relations: time | Show |
| 476 | boolean | no | $zz['fields'][n]['title_append'] | Show |
| 817 | string: HTML | no | $zz['fields'][n]['title_button'] | Show |
| 479 | string: HTML | no | $zz['fields'][n]['title_desc'] description, will always be shown below title in form, values in format will be added automatically (cf. explanation) Relations: $zz['fields'][n]['format']; $zz['fields'][n]['explanation'] | Show |
| 13 | string: HTML | no | $zz['fields'][n]['title'] Title of database field, will be shown in form and table Optional, value will be generated from 'field_name' if not set (first letter uppercase, ending `_id` will be deleted) | Show |
| 998 | string | no | $zz['fields'][n]['title_export_p | Show |
| 478 | string: HTML | no | $zz['fields'][n]['title_tab'] title in table display (optional, default = 'title'), e. g. for abbreviations to save place | Show |
| 289 | boolean | no | $zz['fields'][n]['translate_fiel | Show |
| 774 | array | no | $zz['fields'][n]['translation'] gives the possibility to set individual variables for translation subtables, e. g. 'hide_in_list' | Show |
| 971 | boolean | no | $zz['fields'][n]['trim'] if set to true, 'memo' fields will be trimmed Relations: memo | Show |
| 183 | string | no | $zz['fields'][n]['type_detail'] type of field, used for option and predefined to set real type of field but still remain special functionality Relations: $zz['fields'][n]['type'] | Show |
| 177 | string | no | $zz['fields'][n]['type'] Here, the type of the field can be definfed. For a list of field types, see zz_fieldtypes Relations: zz_fieldtypes | Show |
| 684 | boolean | no | $zz['fields'][n]['unique'] if field value is unique, it can be used for where-clauses and will show only one record in display mode, without add new record | Show |
| 407 | string: HTML | no | $zz['fields'][n]['unit'] displays a unit behind a number, won't display if value = NULL Relations: number | Show |
| 960 | boolean | no | $zz['fields'][n]['update_on_deta Relations: timestamp | Show |
| 885 | string | no | $zz['fields'][n]['upload_default Relations: $zz['fields'][n]['default'] | Show |
| 569 | integer | no | $zz['fields'][n]['upload_field'] Relations: hidden | Show |
| 813 | string: function | no | $zz['fields'][n]['upload_func'] string; name of a function to format upload values (the only way to handle arrays) Relations: $zz['fields'][n]['upload_field'] | Show |
| 571 | string: SQL | no | $zz['fields'][n]['upload_sql'] SQL query to use with upload value, e. g. if you get a string but need an ID value. Relations: hidden; $zz['fields'][n]['upload_field'] | Show |
| 570 | mixed | no | $zz['fields'][n]['upload_value'] Relations: hidden; $zz['fields'][n]['upload_field'] | Show |
| 848 | boolean | no | $zz['fields'][n]['use_as_label'] Relations: subtable; $zz['fields'][n]['tick_to_save'] | Show |
| 636 | array | no | $zz['fields'][n]['validate'] | Show |
| 637 | array | no | $zz['fields'][n]['validate']['fo | Show |
| 175 | string | no | $zz['fields'][n]['value'] Value for field, may not be overwritten Relations: hidden | Show |
| 622 | array | no | $zz['fields'][n]['values'] Sets values for detail records. Lets you ask e. g. for a level of knowledge for a predefined set of languages | Show |
| 975 | string: function | no | $zz['fields'][n][format_0'] function to format fields from sql query Relations: $zz['fields'][n]['sql']; select | Show |
| 331 | array | no | $zz['filter'] Filter for records to be shown | Show |
| 348 | string | no | $zz_conf['filter_position'] position of filter, top, bottom or both Relations: OUTPUT | Show |
| 332 | array | no | $zz['filter'][n] | Show |
| 567 | mixed | no | $zz['filter'][n]['default_select | Show |
| 892 | integer | no | $zz['filter'][n]['depends_on'] Make a filter dependent on the selection of another filter (e. g. for categories and subcategories), using the other filters' where field = value if filter is selected to narrow the results of this filter | Show |
| 573 | string: field | no | $zz['filter'][n]['field_name'] If set, filter value will be used as a default value for this field. | Show |
| 804 | boolean | no | $zz['filter'][n]['hide_all_link' | Show |
| 334 | string | no | $zz['filter'][n]['identifier'] Identifier for filter, will be used in URL. If not set, will be created from 'title'. Relations: $zz['filter'][n]['title'] | Show |
| 893 | boolean | no | $zz['filter'][n]['ignore_invalid | Show |
| 979 | string | no | $zz['filter'][n]['like'] allows to change LIKE "%...%" to something different | Show |
| 337 | array | no | $zz['filter'][n]['selection'] Possible filters, always pairs of record_id and filter title; values starting with »!« will be compared against with !=, »\« escapes possible !-signs | Show |
| 968 | string: SQL | no | $zz['filter'][n]['sql_join'] SQL JOIN to add for filter to $zz['sql'] Relations: $zz['sql'] | Show |
| 785 | string: SQL | no | $zz['filter'][n]['sql'] SQL query that should return two fields, set of record_id and title that will be used for `$zz['filter'][n]['selection']` Relations: $zz['filter'][n]['selection'] | Show |
| 333 | string: HTML | no | $zz['filter'][n]['title'] | Show |
| 335 | string | no | $zz['filter'][n]['type'] * show_hierarchy * list * where (== list, with the only difference that you must not change the field with the where-value anymore, similar to a 'where' in the URL) | Show |
| 988 | array | no | $zz['filter'][n]['where_if'] 'where_if' allows to set a WHERE query individually for each selection | Show |
| 336 | string: SQL | no | $zz['filter'][n]['where'] If type == 'list', this is the required part for the WHERE condition without the equal sign. Might be, even without 'selection', an array for multiple WHERE-conditions connected with OR filter=NULL and filter=!NULL will be translated to the correct SQL query form | Show |
| 265 | array: path | no | $zz['folder'][] array with root, string, field, mode for a folder that must be renamed/deleted after changing the record Relations: ACTION | Show |
| 933 | string: HTML | no | $zz['geo_map_html'] if set, zzbrick/forms module will include a javascript map (e. g. OpenLayers) to display the records via a KML export on this map; a map template and a JavaScript-library is required Relations: $zz_conf['export']; brick_forms() | Show |
| 934 | string | no | $zz['geo_map_template'] template for $zz['geo_map_html'] Relations: $zz_conf['export']; brick_forms(); $zz['geo_map_html'] | Show |
| 974 | boolean | no | $zz['list']['hide_columns_if_emp Relations: LIST; $zz['fields'][n]['hide_in_list_i | Show |
| 266 | array | no | $zz['list']['hierarchy'] display table in a hierarchical view.
Caution:
- these variables might need a lot of memory when handling bigger amounts of records because all record ids have to be saved to memory
- in combination with a WHERE-Condition (`&where[field]=32`), some records might be missing in a branch of a tree because the WHERE-Condition might exclude these records. For the top level, the missing records will be shown read-only Relations: GLOBAL | Show |
| 268 | string: field | no | $zz['list']['hierarchy']['displa Relations: LIST | Show |
| 945 | boolean | no | $zz['list']['hierarchy']['hide_t | Show |
| 912 | integer | no | $zz['list']['hierarchy']['id'] ID of top record in hierarchy if just a subtree shall be displayed Relations: LIST | Show |
| 267 | string: field | no | $zz['list']['hierarchy']['mother Relations: LIST | Show |
| 539 | boolean | no | $zz['list']['tfoot'] shows table foot, e. g. for sums of individual values Relations: LIST | Show |
| 920 | array | no | $zz['set_redirect'] List of redirects that will be added to the database redirects table if an identifier is updated or a record with an identifier is deleted. Might be list of strings (old and new pattern is equal), list of arrays (old and new patterns differ); field_name may be set optionally if more than one identifier is in the field list. Relations: $zz['extra_action']; identifier | Show |
| 8 | string: SQL | yes | $zz['sql'] SQL statement for list display and to get field values for form display | Show |
| 9 | string: SQL | no | $zz['sqlorder'] SQL statement, part must begin with ' ORDER BY', to sort database table | Show |
| 947 | string: SQL | no | $zz['sqlcount'] separate SQL query for counting records if main query is too heavy Relations: $zz['sql'] | Show |
| 985 | string: SQL | no | $zz['sqlextra'] if SQL query is too complex, additional values can be read via 'sqlextra' queries | Show |
| 941 | string: SQL | no | $zz['sqlrecord'] SQL query which will be used only for record view, not for list view Relations: $zz['sql'] | Show |
| 7 | string: field | yes | $zz['table'] Name of database table (might include database name as well, e. g. Database.Table) | Show |
| 216 | string: HTML | no | $zz['title'] optional: h1-heading to be used for form instead of $zz['table'] Relations: OUTPUT | Show |
| 238 | string: HTML | no | $zz['explanation'] Textblock after heading Relations: $zz_conf['footer_text']; OUTPUT | Show |
| 917 | variable | no | $zz['subtitle'][field]['concat'] Relations: OUTPUT | Show |
| 240 | array | no | $zz['subtitle'][field]['enum'] field = $where_id, without tablename;
= $zz['fields'][n]['enum'] where n is the index of the field corresponding to the key Relations: $zz['fields'][n]['enum']; OUTPUT | Show |
| 987 | variable | no | $zz['subtitle'][field]['format'] Relations: OUTPUT | Show |
| 327 | string | no | $zz['subtitle'][field]['link'] heading link provides a link back from the filter text directly below the heading ('var', 'sql') to the main page which triggers the filter (displaying the corresponding record) Relations: $zz['subtitle'][field]['sql']; $zz['subtitle'][field]['var']; OUTPUT | Show |
| 789 | boolean | no | $zz['subtitle'][field]['link_no_ | Show |
| 916 | string: HTML | no | $zz['subtitle'][field]['prefix'] | Show |
| 217 | string: SQL | no | $zz['subtitle'][field]['sql'] [$where_id, without tablename]['sql'] = $zz['fields'][n]['sql'] where n is the index of the field corresponding to the key Relations: OUTPUT | Show |
| 915 | string: HTML | no | $zz['subtitle'][field]['suffix'] | Show |
| 914 | boolean | no | $zz['subtitle'][field]['value'] if true, value of field will be displayed for subtitle | Show |
| 218 | array | no | $zz['subtitle'][field]['var'] ['heading_sub'][$where_id, without tablename]['var'] = array() field from heading_sql-query which shall be used for better display of H2 and TITLE blabla:<br>var1 var2 var3
Relations: OUTPUT | Show |
| 918 | array | no | $zz['unique'] Describes UNIQUE key for detail tables. For updates via zzform_multi() which do not know the record ID of the detail table this can be used to avoid getting this ID first. | Show |
| 821 | array | no | $zz['where'] WHERE condition for record, like via URL where[some_id]=10 | Show |
| 538 | boolean | no | $zz[list']['select_multiple_reco Relations: LIST | Show |
348 records total