Our website is best viewed on a device with a screen width greater than 320px. We'd still love to hear from you, email info@capitan-cms.com or call us on 0 333 666 666 0.

-# DataCapture(type) #-

Capitan has four default data capture forms which can be added to pages by specifying the form type: register, subscribe, enquiry, or notify.


-# datacapture(register) #-

Captures the user as a "customer" (the "Primary Relationship Type" for users in Capitan).

Register

All Fields marked * are mandatory.

Data Processing Confirmation:

Communication Preferences:





-# datacapture(subscribe) #-

Captures the user with an active e-marketing subscription, as a "prospect".

Subscribe

All Fields marked * are mandatory.

Data Processing Confirmation:


-# datacapture(enquiry) #-

Sends captured data to designated email address(es). Stores a copy of the message to the database. Captures the user as a "prospect"

Online Enquiry

All Fields marked * are mandatory.

Data Processing Confirmation:

Communication Preferences:





-# datacapture(notify) #-

Captures the user with an active content notification subscription, as a "prospect".

Subscribe

All Fields marked * are mandatory.

Data Processing Confirmation:


Customisation

Each of these forms can be completely customised in terms of data captured, pre-processing requirements and post processing. Use the following PHP variables to specify the desired settings and add to "Advanced Settings > Additional PHP" on the page where you are adding the form.


$CUST_ID = 'customformdemo';
$CUST_TITLE = 'This is a demo form';
$CUST_TRIGGER = 'DoCustomProcess';

The ID of the form in the DOM, for dynamic purposes or CSS customisation. A custom title which appears above the form within the HTML <legend></legend> attribute. And the trigger code used by the form pre-processor. This becomes important if you are writing bespoke pre-processing or post-processing functions.


$CUST_HIDDEN = '<input name="FRMcustom" type="hidden" value="Something preset" readonly="readonly"/>';
A raw HTML insertion point recommended for adding hidden fields to a form. This might be necessary for bespoke processing.


$CUST_FIELDS = array('name','surname','email');
Define which data types are collected on the form.

$CUST_MANDATORY = array('name','surname','email');
Define which data is mandatory.

## Available data attrubutes ##
salute, name, surname, nickname, email, password, passwordchange, mweb, mtel, dob, sex, add1, add2, city, region, country, zip, file, company, position, facebook, twitter, google, linkedin, interests, source, freetext, int1, int2, int3, text1, text2, text3, directsub, directsubP, directsubT, directsubS, spam, terms


$CUST_INTERESTS_TITLE = 'Who do you read?';
$CUST_INTERESTS = array('Ram Dass','Alan Watts','Terence McKenna');
$ACTIVE_INTERESTS = array('Alan Watts');

Create a dropdown of predefined interests for the user to choose from. Force options to be pre-selected using the active interests variable. The title above the dropdown is also customisable. Collected interests are recorded on the users profile in Capitan.


$CUST_FREETEXT_TITLE = 'Write a story';
The title of the <textarea></textarea> input referred to as "freetext".


$CUST_INT1_TITLE = 'Fav number';
$CUST_INT2_TITLE = 'Number of fingers';
$CUST_INT3_TITLE = 'Mening of life';

You can insert up to 3 customisable fields for collecting numeric data ("int1", "int2", "int3"). These variables control the title applied to the input box. "int1" is limited to 3 digits, "int2" limited to 5 digits, and "int3" to 10 digits.


$CUST_TEXT1_TITLE = 'Fav number';
$CUST_TEXT2_TITLE = 'Number of fingers';
$CUST_TEXT3_TITLE = 'Mening of life';

You can insert up to 3 customisable textarea inputs for collecting numeric data ("text1", "text2", "text3"). These variables control the title applied to the input box. "text1" is limited to 100 characters, "text2" limited to 250 characters. "text3" has no limitation but is intended for use with data that should be hash encrypted.


$CUST_BLANK = 'true';
Setting this variable to 'true' will stop any preset user data appearing in the form. By default, Capitan will pre-populate fields with the relevant data if the end user is a recognised user. For example, if someone has logged in or clicked through to the website via a Capitan email campaign and they go to the contact form, their name, email etc will already be pre-populated in the form so that they don't have to fill the input boxes manually.


$CUST_BASIS = 'legitimate interest';
Capitan captures the lawful basis for processing any data subjects identifiable information. The default setting is "consent" as our forms always require the users consent by ticking an opt-in box. You can use this PHP variable to specify another basis, if required:

(a) Consent: the individual has given clear consent for you to process their personal data for a specific purpose.

(b) Contract: the processing is necessary for a contract you have with the individual, or because they have asked you to take specific steps before entering into a contract.

(c) Legal obligation: the processing is necessary for you to comply with the law (not including contractual obligations).

(d) Vital interests: the processing is necessary to protect someone’s life.

(e) Public task: the processing is necessary for you to perform a task in the public interest or for your official functions, and the task or function has a clear basis in law.

(f) Legitimate interests: the processing is necessary for your legitimate interests or the legitimate interests of a third party, unless there is a good reason to protect the individual’s personal data which overrides those legitimate interests. (This cannot apply if you are a public authority processing data to perform your official tasks.)


$CUST_COUNTRY = 'United Kingdom';
The 'country' attribute presents the user with a dropdown list of countries to choose from. You can use this php variable to pre-select a specific country on the users behalf.


$CUST_BUTTON = 'Click Me!';
The text that appears in the form submit button

Examples » Magia-code » Data Capture

Subscribe to our e-newsletter:

sign up now  

Access Key Enabled Navigation

Keywords for: Data Capture