Feature #34021

Update Documentation of Form Wizard to include postprocessors

Added by Franz Geiger over 5 years ago. Updated about 5 years ago.

Status:
Resolved
Priority:
Should have
Assignee:
Category:
Manuals
Start date:
2012-02-14
Due date:
% Done:

100%

Tags:

Description

Using postprocessors is not documented in the Form Wizard documentation.
Also issue #32701 added an interface for postprocessors.

Attached is a draft to be included in the Form Wizard documentation to describe how to use postprocessors.

Please inlcude this in the manual. Thanks

postprocessor.txt View - Suggested documentation for postprocessors. (1.31 KB) Franz Geiger, 2012-02-17 02:45


Related issues

Related to Core - Feature #32701: Enable customer postProcessors in different folder Resolved 2011-12-19

History

#1 Updated by Stefan Galinski over 5 years ago

  • Tracker changed from Task to Feature
  • Project changed from Core to Documentation
  • Category deleted (Form Framework)

#2 Updated by Robert Wildling over 5 years ago

I would love to see how the senderEmail can be configured dynamically. Entering a fix email address here doesn't seem to make much sense, since I assume this variable is used to send a confirmation email to the writer. Therefore shouldn't it be the variable that is entered under "attributes" of the email form element? Also, there seem to be fields like "senderEmailField" and "senderNameField", which are not documented.

Here is a little bit of discussion going on:
http://lists.typo3.org/pipermail/typo3-german/2011-November/082004.html

Thank you!

EDIT:
Maybe a clear differentiation between fields like "sernderEmail" and "senderEmailField" would be great to mention...

#3 Updated by Franz Geiger over 5 years ago

  • Assignee set to Franz Geiger
  • % Done changed from 0 to 100

Hi Robert,

the senderEmail and senderMail properties (or senderEmailField and senderNameField) are not used to set to whom the email is sent. It just sets the "from:" header in the message and are by default the email address which is set in $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'] and the name set in $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromName'].

Currently there is no option to also send a copy of the message (or a confirmation) to the submitter of the form (i.e. your site visitor).

I just uploaded an updated documentation to clarify this. You can see the patch and the new manual here:
https://review.typo3.org/#/c/9550/

Regards,
Franz

#4 Updated by Chris topher over 5 years ago

  • Status changed from New to Under Review
  • Patch is reviewed set to No
  • Has patch set to No

Patch set 1 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/9550

#5 Updated by Gerrit Code Review over 5 years ago

Patch set 3 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/9550

#6 Updated by Robert Wildling over 5 years ago

Thank you for updating the manual! - I still don't get the difference between recipientEmail and senderEmail, and why BOTH are required fields in the form. If someone uses the form, the form sends the mail to the recipientEmail, doesn't it? The senderMail is ... who? (Sorry for being slow and stupid on this one... I think, though, that the new form extension is awesome! I would love to see some funtionality that powermail has eg --- like the "send mail to the one who wrote it" ...)

#7 Updated by Franz Geiger over 5 years ago

Hi Robert,

your desired function "send mail to the one who wrote it" can be achieved by setting up a form element "email" and setting

recipientMailField = email

But you can not send the email to yourself and to the one who wrote it. That is currently not possible.

The difference between recipientMail(Field) and senderMail(Field) are shown in the following example: Imagine the following being the mail message that gets sent by the form:

Date: Mon, 12 Mar 2012 12:09:16 +0100
From: Sender Name <sender-email@example.com> // as set in senderName(Field) and senderEmail(Field)
Subject: Subject // as set in subject(Field)
To: Recipient Name <recipient-email-address@example.com> // as set recipientName(Field) in recipientEmail(Field)

Hello,
this is the content of the message.

So the recipientEmail is the email address the actual message gets sent to and the senderEmail is the address that appears as the sender of the message.
Imagine a setup where you want visitors of your site to have a way of contacting you: You configure the plugin to take all the information you want (e.g. the name of the visitor, his/her contact details for being able to contact him/her back, a message) and send the gathered information to yourself.
So you configure the postprocessor to always send the message to your address:

recipientEmail = robert-wildling@example.com

Now you could either configure the postprocessor to show the actual contact details of your site visitor as sender information:
senderEmailField = email

Or you could want to have something like "Mail from contact form from my website" as a subject and "" as the sender:
senderEmail = contact-form-dont-reply@your-website-domain.com
subject = Mail from contact form from my website

I hope that makes it a little more understandable.

Regards

#8 Updated by Gerrit Code Review over 5 years ago

Patch set 4 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/9550

#9 Updated by Gerrit Code Review over 5 years ago

Patch set 5 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/9550

#10 Updated by Chris topher over 5 years ago

  • Category set to Manuals

#11 Updated by Gerrit Code Review over 5 years ago

Patch set 6 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/9550

#12 Updated by Chris topher about 5 years ago

  • Status changed from Under Review to Resolved

This has been committed in changeset 7289496.

Also available in: Atom PDF