Contact forms

Introduction

Plone ships with a

  • site contact form which is form-to-mail to the site administration email
  • document comment form
  • email this to friend form

Default address /contact-info.

Customizing site contact form

Contact form files are

  • Products/CMFPlone/skins/plone_templates/contact-info.cpt
  • Products/CMFPlone/skins/plone_templates/contact-info.cpt.metadata
  • Products/CMFPlone/skins/plone_templates/site_feedback_template.pt
  • Products/CMFPlone/skins/plone_formscripts/validate_feedback.vpy
  • Products/CMFPlone/skins/plone_formscripts/send_feedback.cpy
  • Products/CMFPlone/skins/plone_formscripts/send_feedback.cpy.metadata
  • Products/CMFPlone/skins/plone_formscripts/send_feedback_site.cpy
  • Products/CMFPlone/skins/plone_formscripts/send_feedback_site.cpy.metadata

Inspect the files to known which you need to change. Copy these files to skin layer folder (any folder under skins) in your add-on product.

Note

Different contact for is displayed for logged-in and anonymous users. Logged in user email is not asked, but one stored in member properties is used.

Example

Below is an example how to add "phone number" field for all not logged in users feedback form.

Add a new optional field to contact-info.cpt (language hardcoded):

<div class="field">

  <label for="phone_number">
    Puhelinnumero
  </label>

  <div class="formHelp">
    Puhelinnumero, mik&#xe4;li haluatte teihin oltavan yhteydess&#xe4; puhelimitse.
  </div>

  <input type="text"
         id="phone_number"
         name="phone_number"
         size="25"
         value=""
         tal:attributes="value request/phone_number|nothing"
         />
</div>

Refer this field in site_feedback_template.pt:

<div i18n:domain="plone"
     tal:omit-tag=""
     tal:define="utool nocall:here/portal_url;
                 portal utool/getPortalObject;
                 charset portal/email_charset|string:utf-8;
                 dummy python:request.RESPONSE.setHeader('Content-Type', 'text/plain;;charset=%s' % charset);"
>

<div i18n:translate="site_feedback_mailtemplate_body" tal:omit-tag="">

You are receiving this mail because <span i18n:name="fullname" tal:omit-tag="" tal:content="options/sender_fullname|nothing" />
<span i18n:name="from_address" tal:omit-tag="" tal:content="options/sender_from_address"/>
is sending feedback about the site administered by you at <span i18n:name="url" tal:replace="options/url" />.
The message sent was:

<span i18n:name="message" tal:omit-tag="" tal:content="options/message | nothing" />

</div>
--
<span tal:replace="portal/email_from_name" />

</div>

Puhelinnumero: <span tal:content="request/phone_number|nothing" />

Note

As a crude hack we add new field to the very bottom of the email, as everything side <div i18n:translate> is replaced from translation catalogs.

Replacing the site contact form with a content object

Sometimes you want to turn off the builtin form in favour of a piece of content. For example you might want a PloneFormGen form that content editors can alter. Naming your content item contact-info works because Zope traversal will find your content item before the page template. However Plone won't allow a new piece of content to be named contact-info since that's a reserved identifier, so the trick is to rename it in the ZMI from the Plone-generated contact-info-1 back to contact-info.

This works for accessibility-info too.

If you have a PFG contact form at, say, about/contact-us and want to turn off the builtin contact-info form, use the rename trick to create a contact-info Link object at the site root that points to your new form. Through acquisition, even URLS like events/contact-info will successfully redirect to your custom form.