Fabrik User Manual 0

•
• Default to current date - Default to the current date
• Always return todays date - Regardless of any other setting the element will
always show todays date. Useful when you want to record the date/time that the
record was updated.
• First Week day - Which day is defined as the first day of the week, use 0 for
Sunday, 1 for Monday etc
• Allow typing in field - If set to no then users can not manually type in data
into the fields, but are obliged to use the widgets to enter the date.
• Show time selector - show an additional time selector next to the date picker -
an example of how this looks is shown below:
• Time format - The strftime format string to use when formatting the time part
of the data (applicable only to the form view)
Display text
Simply displays the element label on its own.
TIP If you need HTML formatted text here then go to tables->parameters and select 'yes'
for the 'Use WYSIWYG editor for element labels' option.
• Eval - evaluate the label as a PHP function.
• Default - The default value to populate the element with. If the eval option is
selected then this should contain a PHP statement
E.g.
return 'default';
• Show label - Should the form show the label as well as the display text
50

---

Drop down
Sub Elements
• Add - Press this to add in a new drop down option
• Value - The value that is stored in the database if the drop down option is
selected
• Label - The label that appears next to the drop down option. Equally this label is
shown in the table view rather than the recorded value (which is stored in the
database table itself)
• Default - is the option selected as default
• Delete - Press this to delete the drop down option
• Note: you can reorder the sub elements by clicking down on the grey bar to the
left of the value field and dragging it within the list.
Options
• Multiple selections - if yes then uses can ctrl click to select multiple options
from the list
51

---

• Multiple selections height - if multiple selections turned on then this value
represents how many options are visible in the list before you have to start
scrolling it
• Eval - evaluate the label as a PHP function.
• Default - The default value to populate the element with. If the eval option is
selected then this should contain a PHP statement
E.g.
return 'default';
Add Options
• Allow user to add drop down option - Allow your form's users to add in
additional options to your form.
• Only add label - If no selected then the user has to enter both a value and a
label for the checkbox option they are adding. If yes selected then only a label
field is presented to the user the value of which is then used for the value and
label.
• Save new additions - If yes selected then the newly submitted option is stored
by the element, meaning subsequent users of the form will be able to select the
same value.
52

---

Field
• Width - - The width of the date field - the value represents the number of
characters that can be displayed
• Hidden - sets the date to be rendered as a hidden field
• Eval - If set to yes then the value entered in the default field is taken to be a
PHP expression and is evaluated as such.
• Default - The default value to populate the element with. If the eval option is
selected then this should contain a PHP statement
• Password - Render the field as a password field (text entered is show as a
series of "*"'s
• Maximum length - The maximum number of characters the user is allowed to
type into the field.
• Format - Define what type of data the field should store in the database
• Integer length - The length of the integer field when the format is set to
integer or decimal
• Decimal length - The decimal length stored in the database when the format is
set to decimal
• Format string - Applies the PHP sprintf function to the string -
http://fr2.php.net/sprintf when displaying the data in the table view or detailed
view.
• Guess link type - Will try to guess if the data entered is a URL or email
address, if so then in the table view and detailed view the data is encased with
the corresponding link
53

---

• Disable element - Disable the element, the user is not allowed to changed the
value and the value is NOT stored in the database.
• Read only - The user is not able to change the field's value but the value IS
stored in the database.
File upload
Options
54

---

• Maximum file size - The maximum file size in Kb of any file uploaded by this
element
• Allowed file types - A comma separated list of file extensions that are allowed
by the element,
E.g.
.jpg, .jpeg, .gif
Leave blank to use Joomla's default list of allowed file extension
• Upload directory - the folder into which the uploaded files can be stored
• Email uploaded file to recipients - If set to yes then the uploaded files are
attached to any email's sent by the form's email plug-in
• Obfuscate Filename - Adds a random series of numbers or letters onto the end
of the filename
• Length random filename - the number of random characters to add to the file
name when 'obfuscate filename' selected
• If existing image found?
◦ Leave original file - the newly uploaded file will not be stored on the
server
◦ Leave original file and increment new file's name - the original file will be
left on the server and the newly uploaded file's name will be amended
(each new file name will be pre-pended with the version number)
• Allow subfolder selection - If set to yes then a drop down appears next to the
upload element field, from which the user can select which sub folder to upload
the file into.
• Delete images? - If set to yes, then if a record is deleted from a Fabrik table
the files contained within that record are also deleted from the server. If set to
no then the files are left on the server.
Display
• Default image - Enter the path to a image to display if none currently available
• Link to file - Create a link to the file when in the table view. Requied if you
want to use a lightbox in the table view.
• Show media in table - If set to yes then Fabrik will show the media in the
table. Depending upon the media type this may be an image, flash, video or a
icon representing a document.
• Show media in form - same as 'show media in table' except this option effects
displaying the media in the form.
• Image library - The image library you wish to use to process images with (used
when resizing and cropping any uploaded images)
• Max width - When uploading images this specifies the maximum width in pixels
that that image can be, if the uploaded image is wider than this value the main
image is scaled down so that its width is no greater than this value.
• Max height - When uploading images this specifies the maximum height in
pixels that that image can be, if the uploaded image is higher than this value the
main image is scaled down so that its height is no greater than this value.
• Title element - If either 'show media in form' or 'show media in table' selected
then the data contained within the title element will be used in the lightbox title.
Thumbnail
• Make a thumbnail of the uploaded image - If set to yes and an image
uploaded then a thumbnail image is also created. This image is used in
preference to the main image when rendering data in the table, form and
detailed views.
55

---