[eZ publish] (Tranfer) Build a form use the information collector

Creating a custom form

To do this, log in to the Administration Interface and click on the Setup tab. In the left menu, click the Classes link:

 

 

 

Add attribute

Note that the attributes that will collect information (through form fields presented to the visitor) need to have the Information collector checkbox marked:

Information collector checkbox

Rather than repeating theexplanation of the steps to add each attribute, the information for allthe attributes is summarized in the table below:

Name

Identifier

Datatype

Required

Searchable

Information collector

Form Name

form_name

Text line

Yes

Yes

No

Form Introduction

form_introduction

XML block

No

Yes

No

Given Name

given_name

Text line

Yes

No

Yes

Family Name

family_name

Text line

Yes

No

Yes

Date of Birth

date_of_birth

Date

Yes

No

Yes

Contact Phone Number

contact_phone_number

Text line

Yes

No

Yes

Email Address

email_address

E-mail

Yes

No

Yes

Postal Address

postal_address

Text block

Yes

No

Yes

Please send me information about the club's tennis tournaments

option_play_in_tournaments

Checkbox

No

No

Yes

Please send me information about tennis classes and professional coaching

option_classes_and_coaching

Checkbox

No

No

Yes

I would like to receive the monthly club newsletter by email

option_club_newsletter

Checkbox

No

No

Yes

Please keep me informed about the club's social events and competitions

option_social_events_
competitions

Checkbox

No

No

Yes

Can we help by answering any questions?

other_questions

Text block

No

No

Yes

Membership Coordinator E-mail Address

membership_coordinator_email_
address

E-mail

Yes

No

No

When using the first method, thepage will automatically reload with the attribute order changed.However, if the attributes are renumbered using the second method, youmust click the Apply button (or OK button if you are finished editing the class) to store the changes.

 

Saving the new class

Once you have entered all the relevant attribute information, click the OK button to add the new class.

The next step is to modify the appropriate INI settings in order to configure the form.

Defining how information is collected

The settings/collect.ini file contains some useful form options.

Recall from the first article in this seriesthat eZ Publish reads basic settings from the default INI files, whichare overriden by any settings in the specific siteaccess overrides,which are overridden by settings in the global override files. Youshould never modify the default INI files.

The settings below should be created in the file collect.ini.append.php located either:

  • In the directory for the siteaccess (in settings/siteaccess/[name_of_siteaccess]/) that will display the form; or

  • In the override directory (in settings/override/), meaning it will apply to all siteaccesses.

If the override file does not already exist, you must create it.

The sections below show thesettings that need to be included in the INI file. Note that linesstarting with hash symbols are comments.

[InfoSettings] block

The setting below specifies thatthere is an information collector based on the class ID“membership_application_form”, and that the identifier for theinformation collector is the same as the class name.

[InfoSettings] # Matches class id or identifier to information collection type TypeList[membership_application_form]=membership_application_form

[EmailSettings] block

Sometimes it is useful to send anemail summarizing the results of each form submission. This is notrequired for objects such as polls, but we will use it in ourmembership application form.

[EmailSettings] # Matches class id or identifier to information collection type # SendEmailList[poll]=disabled SendEmailList[membership_application_form]=enabled

[DisplaySettings] block

The DisplayList setting specifies the page that should be loaded after the form is submitted. There are three main options:

[DisplaySettings] # result  - Display IC result, for instance poll result or your form data # redirect - Redirect to a specific url # node    - Redirect back to content node # Matches class id or identifier to information collection type #DisplayList[poll]=result DisplayList[membership_application_form]=result

[CollectionSettings] block

Some forms need to be available to anonymous users. This is determined by the setting below.

[CollectionSettings] # if enabled then information from anonymous users can be collected # CollectAnonymousData=enabled # Same as CollectAnonymousData but is a list of IC types and # their override settings, if specified it will override default setting CollectAnonymousDataList[membership_application_form]=enabled
# How information collection is handled in terms of user identification
# # multiple - each user can submit multiple data # unique - one set of data per user, if already exists give a warning # overwrite - one set of data per user but new entry overwrites old one CollectionUserData=multiple # Matches class id or identifier to information collection type #CollectionUserDataList[feedback]=multiple CollectionUserDataList[membership_application_form]=multiple

Making the form visible in the site’s menus

eZ Publish does not automaticallyinclude objects of a new class in the default top or left site menus.For example, the top menu displays the objects that are directly belowthe top-level node of the Content branch, but only for the classesspecified in menu.ini. Similarly, the left menu displays theobjects that are directly below the second-level node that is currentlybeing viewed, but also only for the classes specified in menu.ini. The new Membership Application Form class needs an entry in the relevant menu.ini file.

This example uses the Website Interface extension, so either of these settings override files can be edited:

/extension/ezwebin/settings/menu.ini.append.php

OR

/settings/override/menu.ini.append.php

The entries added are shown below.

menu.ini settings

This may not be necessary for allforms if you do not need them to be visible in the top or left menus(for example, if you are just going to link to the form in the body ofan article). In our case, we have added the appropriate entries to boththe TopIdentifierList setting (objects of these classes are shown inthe flat_top menu template at extension/ezwebin/design/ezwebin/templates/menu/flat_top.tpl), and the LeftIdentifiersList setting (objects of these classes are shown in the flat_left menu template at extension/ezwebin/design/ezwebin/templates/menu/flat_left.tpl).

Menu areas

posted @ 2010-04-21 10:30 DavidHHuan 阅读(...) 评论(...) 编辑 收藏