# Help: Contact

#### DESCRIPTION

'Contact Us' is a very simple module. It provides a Main Menu link to a contact form that visitors can use to email the website Administrator. You can set the content of the Contact Us form in 'Preferences'

#### INSTALL/UNINSTALL

No special measures necessary, follow the standard installation process – extract the /contact folder into the ../modules directory. Install the module through Admin -> System Module -> Modules.
Detailed instructions on installing modules are available in the XOOPS Operations Manual

#### OPERATING INSTRUCTIONS

There is nothing really to do on the Admin site, except setting preferences.

#### TUTORIAL - Module preferences

##### Options for Captcha

Here you can define, whether you want use Google reCaptcha or not.
If you want to use reCaptcha, you have to register your website at Google first. In order to get the necessary website-key, do following steps:

- If you are not registered at Google, you have to register yourself first
- Goto website https://www.google.com/recaptcha/admin
- Simply enter your corresponding website (label and domain):
- After clicking on "Register" you get a new site with the required website-key:
- Copy the website-key and paste it to module preferences
- done

More about Google reCaptcha under https://www.google.com/recaptcha.

##### Form options

Here you can define, which additional fields you want provide in your contact form.

##### Options for usage of departments/recipients

This option allow you to define a department/email combination.
Users selecting from a defined department will have their contact information sent to the corresponding email address you define.
Define each department/email as follows:
"dept1,email1|dept2,email2|dept3,email3" etc. - each department and email must be separated by a comma ',', and each department email combination must be separated by a pipe '|'
If no department/recipient is defined, than the mail will be sent to standard email address.
This option will be only used, if the option "Show select Departments" is set "yes".
With the options "Add Department as Prefix?" and "Additional Email's Subject Prefix" you can define, that the selected department with the additional text will be used before the subject text, given by the contacting person, e.g. "[Contact dept1]: Subject text original". this will also only used, if the option "Show select Departments" is set "yes".
If no department is defined or the option "Show select Departments" is set "no", the contact mail will be automatically sent only to standard email address.

##### Options Information

###### Header contact form

Here you can define a welcome or information text, which will be shown on the top of the contact form. You can use html-code.

###### Embed google maps

If you want to embed your location with google maps, than you must paste the corresponding code for the iframe here. To get the correct iframe-code, do following steps:

- Search the location in google maps
- Click on "Settings":
- After click on "Share or embed map" select tab "Embed map":
- Copy the iframe-Code and paste it in module preferences
- If necessary, change width of iframe to 100 %.
- done

##### Misc options

###### Standard recipient

Each contact will be sent to this email address. If no email address is defined, the contact mails will be sent to site webmaster (Admin email address in xoops general settings).

###### Send confirmation mail?

You can define that automatically a confirmation mail is sent to the email, given by the contact form. This confirmation mail contains the given subject and mail content. You can change this text in language file main.php under _MD_CONTACT_MAILCONFIRM_BODY.