1. Introduction
    1.1 Features
    1.2 Description of the module

2. Adding the module

3. Configuration options
    3.1 Content
        3.1.1 Configure: Mailpage configuration
        3.1.2 Destination: Mailpage destinations overview
   Destination: Add new destination address
   Destination: Edit destination address
    3.2 Advanced options

4. The module in practice: tips
    4.1 Error: no destination address for page nn
    4.2 Change texts in the Translate Tool
    4.3 Sort order

5. CAPTCHAs and visually impaired

6. Concluding remarks

1. Introduction

The Mailpage module enables website visitors to send e-mails to one or more destination addresses.

1.1 Features

Main features of the Mailpage module:

1.2 Description of the the module

Embedded in the Frugal theme (see Theme Frugal, paragraph 1.2 Description of the theme) is the Mailpage module.

When you are on the Exemplum home page, i.e. the demonstration data, either click the toplink Contact or click the section 'School info' and next the page 'Contact' to enter the Mailpage module:

[ Mailpage on website, destination dropdown menu expanded, pricipal selected, header, intro text, name, email address, subject, buttons ]
We have entered some (fictional) data in the fields.

The Mailpage has, from top to bottom, the following items:

Clicking [Preview] opens the next screen where you can examine your work, [Cancel] reopens the Mailpage without any data entered.

When Javascript is not used or disabled, the two descriptions of the demonstration data are displayed:

[ no dopdon menu, 2 introduction texts displayed ]

Below the dropdown menu both the introduction texts of Principal and Webmaster are visible:
- Principal: Please send all your educational questins to our principal, Amelia Cackle
- Webmaster: Please send all your website-related (technical) questions to our webmaster.
Allother fields are the same.

After entering at least the required fields, clicing the [Preview] button opens the Preview page:

[ Preview page, example text ]

The Preview page has, from top to bottom, the following items:

Clicking [Edit] reopens the previous screen for re-editing, [Candel] reopens the Mailpage without any data entered.

Pressing the [Send] button opens the Message has been sent page:

[ message sent page, example text ]

The 'Message has been sent' pane has, from top to bottom, the following items:

Below is the content of the mail as received by the Principal:

Subject: [7] Message from A. Reese to Exemplum High
From: (M. Johnson)
To: Principal
Subject: A. Reese to Exemplum High
Date: Day, nn Mon yyyy hh:mm:ss UTC-offset
IP-address: nnn.nnn.nnn.nnn (nn)
Dear Mrs. Cackle,
To our great joy, Andrew is accepted!
More to follow.
With amicable greetings,

On the first subject line the [n] indicates the page number and 'from:' shows the (fictional) IP address of the sender. The (nn) is the time in seconds it took to create the message.
Using the 'Reply' function in your mail program automatically puts the email address M. Johnson <> in the To: field.

If, in the configuration of the Mailpage only one address is created, the dropwdown menu is not displayed:

[ Mailpage: message sent ]

Mailpage with only the header text, intro text, name, e-mail, subject, message and 2 buttons: Preview, Cancel.


2. Adding the module

Adding a module supposes that you have sufficient access permissions to add a page. This is specially important for non-webmasters like pupils and teachers who often have limited permissions. These permissions are set in the Account Manager, most times by the webmaster Wilhelmina Bladergroen.

In the Page Manager, select the Area or Section and click on the Add a page link to enter the Add a page dialogue:

[ add a page, module menu expanded, contact form selected ]

Fill out the fields as described in Page Manager, paragraph 3.1 Add a page.
In the Module dropdown menu, select the module. Do not forget to select Visible, Hidden or Embargo. Click [Save] to save your work and return to the Page Manager.
Now click on the Page Name to enter the Module Name (modulename) configuration dialogue. In the next paragraph the module will be configured.


3. Configuration optionsns

3.1 Content overview

To edit the content of the Mailpage module, open the Page Manager, click the Page Name link to open the Mailpage content overview dialogue:
[ configure ]

Mailpage Content Overview
Here you can conf configure the Mailpage module for this page.

Using the link Configure in the submenu you can add an optional header and an optional introduction to the mailpage. Also, it is possible to enter a default message. The visitor will see this default message in the message field. This allows for a simple way to let the visitor answer multiple questions in a single message.

Using the link Destinations in the submenu you can add new destinations, or edit or delete existing destination addresses.

The mailpage requires at least one valid destination address.


3.1.1 Configure: Mailpage configuration

Clicking the Configure opens the Mailpage configuration dialogue:
[ content: configure ]
In the Menu the Content and Configure links are selected. The workplace pane consists of: On the Mailpage the message will be displayed as:
[ configuration options ]

3.1.2 Destination: Mailpage destinations overview

To configure the destinations, in the Menu, click Destination, to open the Mailpage destinations overview dialogue:
[ Content: destinations ]
In the Menu, the Content and Destination links are underlined. In the Workplce we see:

Mailpage destination overview
Here you can configure destination addresses for the Mailpage module for this page. You can add a new destination address, edit an existing destination address or delete an existing destination address.

Note: The mailpage requires at least one valid destination address. Destination: Add new destinations address

[ Content: destinations ]
Add new destination address
Here you can enter the details of the new destination addresses. You MUST add at least one destination address for this module to work. Destination: Edit destinations address

To edit an address, go to the Mailpage destinations overview dialogue and click a Name on the list, to enter the Edit destomatopm address dialogue:
[ Content: destinations ]

Edit destination address
Here you can modify destination addresses. You MUST configure at least one destination address for this module to work.

3.2 Advanced options

The advanced options also apply to this module. In particular it means that you can use Bazaar Style Style (BSS) to get rid of awfful colors that mismatch with the school site or with the pictures on the page.
More on the backgrounds of BSS can be found in chapter Viewpoints, paragraph 4. On form and content.
More on the practical work can be found in Configuration Manager, paragraph 3.4 Configure theme 'Theme Name' for area n. The other advanced options are discussed in chapter Page Manager, paragraph 3.3 Advanced: edit advanced properties of page nn.


4. The module in practice: tips

4.1 Error: no destination address for page nn

[ error no addresses for page ]

You added the module, but forogot to configure it.

4.2 Change texts in the Translate Tool

In the Traanslate Tool you can, if necessary change some texts that are not configurable in the module. For example:
43: Preview
51: Message has been sent 
52: Here is a copy of your message.

4.3 Sort order

The sort order is defined as 10, 20, 30, et cetera. This enables you to put an address between 10 and 20, for example 11, 12 etc. When using 1, 2, 3, adding a destination between 1 and 2 needs also reordering the other numbers. Note that the destinations are automatically renumbered after saving.

5. CAPTCHAs and visually impaired

Some links on this annoying issue:


6. Concluding remarks



Author: Dirk Schouten <dirk (at) websiteatschool (dot) eu>
Last updated: 2014-09-06