Submit Site Setup - Fields
Fields control what actions are taken during the submission process. Each field represents a control within a form. The "Field Wizard" can usually take care of most of the field setup, but some more complex sites may require some manual entry.
Each field has several important properties:
Field Name - This is how Submit Machine looks for the field.
Default Value - A default value to enter in the field, will be used if the Map To is set to 'Default Value'.
Field Type - Determines the type of field and how to fill in the field.
Map To - Determines the value from the gallery to fill the field with.
Field Types
Text Box
This is the most common field type, this can be an INPUT (of type text, textarea, password, or hidden) or TEXTAREA tag in a web form. Submit Machine will find Textboxes via the name attribute in the HTML. A textbox will be erased before it is filled in.
Example:
Append Text
Append Text is like a TextBox, but instead of erasing what is in the textbox, it will append to the end of whatever text is currently in the text box. This is useful for adding tags (i.e. "(NSFW)", etc.) to a field for a certain site.
Private Text Box
Private Text Box is the same as a TextBox, but will not output a default value when a Submit Site is exported. I personally use this for storing username, password, and site name information for sites that have you enter this information during the submission process.
Select List
Select Lists are also known as drop down lists or combo boxes. They allow you to select a value from a list of preset values. The mapping for a Select List is always 'Default Value'. The default value for a select list must be one of the values within the list of options in the list. Select lists are found by the name attribute on the SELECT tag in the HTML.
Example:
Check Box
Checkboxes represent a check box within a web form. Checkboxes are found by the name attribute on an INPUT tag (of type checkbox). Checkboxes do not take a mapping or default value into account, and they are simply clicked. If the check box is checked by default, it will be unchecked when clicked.
Example:
Check me
Radio Button
A radio button represents a list of options within a web form. A radio button should usually be mapped to a Default Value. The radio button is found and clicked based on the name attribute and the value attribute.
Example:
Image URL
Upload Image
File Upload
The File Upload field type allows you to upload a file to a submission form. The File Upload field is usually mapped to the Picture Path. For a file upload, the submitter will navigate to the file on your file system and upload it. If the file does not exist, the submission will fail. File Upload fields are found by the name attribute.
Example:
Button
The Button field type will click a button in a submission form. This is useful for multi-page submission forms. This field type does not use a mapping or default value. The button field type is found by the value attribute on the button. The value attribute is the text that is displayed on the face of the button.
Go To URL
The Go To URL field type will navigate the browser to a specified URL during the submit process. This is useful for some multi-page submission forms or for navigating complex menus before submitting. The default value and mapping are not used. Enter the URL to navigate to in the Field Name.
Prefill Text Box, Prefill Select List, and Prefill File Upload
These field types work exactly like their previously mentioned counterparts, but these fields allow you to select a value before the submission process begins. These fields are great for "prefilling" categories, tags, odd sized images, babe names, etc. You can map to a default value, or opt to prefill the field with one of the gallery value mappings.