... |
... |
@@ -7,7
+7,7 @@ |
7 |
7 |
== Functionalities == |
8 |
8 |
|
9 |
9 |
; mmediate notification |
10 |
|
-: Via the {{smallcaps}}}Imap{{/smallcaps}} interface the user is immediately informed about new or changed form entries. |
|
10 |
+: Via the {{smallcaps}}Imap{{/smallcaps}} interface the user is immediately informed about new or changed form entries. |
11 |
11 |
; Configurable content |
12 |
12 |
: The content of the notifications as well as their subject, sender and recipient fields can be freely configured using corresponding templates. Since [[placeholders>>doc:Formcycle.UserInterface.Variables||target="_blank"]] can be used here, links for re-display directly within the mailbox can be created in addition to individual values or metadata of the form input. |
13 |
13 |
; Provision of files |
... |
... |
@@ -17,7
+17,7 @@ |
17 |
17 |
; Manage form entries |
18 |
18 |
: In addition to the actual display, there are also options for managing form entries. For example, a form entry is moved to the corresponding {{formcycle/}} mailbox when it is moved to another folder. Furthermore, the read status is also synchronized. The deletion of form entries is also possible by deleting the corresponding message or by moving it to the trash, if the user has the appropriate authorization. If this authorization is missing, the message reappears in the e-mail program after a few seconds. |
19 |
19 |
|
20 |
|
-The provided {{smallcaps}}Smtp{{{/smallcaps}} server is currently without functionality, so sent messages are completely discarded by it. |
|
20 |
+The provided {{smallcaps}}Smtp{{/smallcaps}} server is currently without functionality, so sent messages are completely discarded by it. |
21 |
21 |
|
22 |
22 |
== Installation == |
23 |
23 |
|
... |
... |
@@ -40,23
+40,24 @@ |
40 |
40 |
{{id name="server_config"/}} |
41 |
41 |
|
42 |
42 |
; smtp.binding.address |
43 |
|
-: Default value: //0.0.0.//. Specifies the {{smallcaps}}ip{{/smallcaps}} address of the {{{smallcaps}}Smtp~{{{/smallcaps}} server to use. The default value is //0.0.0.0//, which uses an automatically generated {{smallcaps}}ip{{/smallcaps}}. Changing this value is only necessary if multiple network adapters are in use or the automatic detection fails. |
44 |
|
-; smtp.binding.port |
45 |
|
-: Default value: //25//. Specifies the port of the {{smallcaps}}Smtp{{/smallcaps}} server to use. The default value should only be changed if this port is not available. |
46 |
|
-; imap.binding.address |
47 |
|
-: Default value: //0.0.0.0//. Specifies the IP address to use for the {{smallcaps}}Imap{{/smallcaps}} server. The default value is //0.0.0.0//, which also uses an automatically generated {{smallcaps}}ip{{/smallcaps}}. Changing this value is only necessary if multiple network adapters are in use or the automatic detection fails. |
48 |
|
-: Default value: //143//. Specifies the port of the {{smallcaps}}Imap~{{{/smallcaps}} server to use. The default value should only be changed if this port is not available. |
|
43 |
+: Default value: //0.0.0.//. Specifies the {{smallcaps}}ip{{/smallcaps}} address of the {{smallcaps}}Smtp~{{/smallcaps}} server to use. The default value is //0.0.0.0//, which uses an automatically generated {{smallcaps}}ip{{/smallcaps}}. Changing this value is only necessary if multiple network adapters are in use or the automatic detection fails. |
|
44 |
+; smtp.binding.port |
|
45 |
+: Default value: //25//. Specifies the port of the {{smallcaps}}Smtp{{/smallcaps}} server to use. The default value should only be changed if this port is not available. |
|
46 |
+; imap.binding.address |
|
47 |
+: Default value: //0.0.0.0//. Specifies the IP address to use for the {{smallcaps}}Imap{{/smallcaps}} server. The default value is //0.0.0.0//, which also uses an automatically generated {{smallcaps}}ip{{/smallcaps}}. Changing this value is only necessary if multiple network adapters are in use or the automatic detection fails. |
|
48 |
+: Default value: //143//. Specifies the port of the {{smallcaps}}Imap~{{/smallcaps}} server to use. The default value should only be changed if this port is not available. |
49 |
49 |
|
50 |
50 |
=== Configuration of the e-mail message === |
51 |
51 |
|
52 |
|
-{{id name="message_files_config"/}} |
53 |
|
-; mail.to.template |
54 |
|
-: Default: //mail_to.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail recipient. |
55 |
|
-; mail.from.template |
56 |
|
-: Default: //mail_from.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail sender. |
57 |
|
-; mail.subject.template |
58 |
|
-: Default: //mail_subject.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail subject. |
59 |
|
-; mail.body.template |
|
52 |
+{{id name="message_files_config"/}} |
|
53 |
+ |
|
54 |
+; mail.to.template |
|
55 |
+: Default: //mail_to.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail recipient. |
|
56 |
+; mail.from.template |
|
57 |
+: Default: //mail_from.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail sender. |
|
58 |
+; mail.subject.template |
|
59 |
+: Default: //mail_subject.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail subject. |
|
60 |
+; mail.body.template |
60 |
60 |
: Default: //mail_body.txt//. Specifies the name of the file to be searched for in the client and form files and to be used as a template for the e-mail content. |
61 |
61 |
|
62 |
62 |
== Configuration of e-mail contents and fields == |
... |
... |
@@ -63,16
+63,16 @@ |
63 |
63 |
|
64 |
64 |
The configuration of the contents and fields of the actual message uses a template mechanism. This is based on the four files set in [[e-mail message configuration>>||anchor="message_files_config"]]. These are imported as a client file when the plugin is installed and are used when synchronizing the messages.To ensure a form-specific display, it is possible to create identically named files manually as form files and thus overlay the client files. In all files it is possible to use [[placeholders>>doc:Formcycle.UserInterface.Variables||target="_blank"]] so that form data sent here can be displayed. It is also possible to create a link to display the filled out form. |
65 |
65 |
|
66 |
|
-; Content |
|
67 |
+; Content |
67 |
67 |
: Default value: //mail_body.txt//. Specifies the content of the e-mail message. Only here you have the possibility to use {{smallcaps}}Html{{/smallcaps}}. |
68 |
|
-Example: {{code language="html"}} <html> <head></head> <body> <p><a href="[%$FORM_INBOX_LINK%]">Link</a> to form entry ([%$PROCESS_ID%]).</p> </body> </html> {{/code}} |
69 |
|
-; Subject |
|
69 |
+Example: {{code language="html"}} <html> <head></head> <body> <p><a href="[%$FORM_INBOX_LINK%]">Link</a> to form entry ([%$PROCESS_ID%]).</p> </body> </html> {{/code}} |
|
70 |
+; Subject |
70 |
70 |
: Default value: //mail_subject.txt//. Specifies the subject of the message. |
71 |
|
-Example: {{code language="none"}} ID: [%$RECORD_ID%] - [%$STATUS_NAME%] {{/code}} |
72 |
|
-; Recipient |
|
72 |
+Example: {{code language="none"}} ID: [%$RECORD_ID%] - [%$STATUS_NAME%] {{/code}} |
|
73 |
+; Recipient |
73 |
73 |
: Default value: //mail_to.txt//. Specifies the recipient of the message. This is to be entered according to the pattern //name <user@example.com>// and has no effect on the actual receipt of the message. |
74 |
|
-Example: {{code language="none"}} XIMA FORMCYCLE <no-reply@example.com> {{/code}} |
75 |
|
-; Sender |
|
75 |
+Example: {{code language="none"}} XIMA FORMCYCLE <no-reply@example.com> {{/code}} |
|
76 |
+; Sender |
76 |
76 |
: Default value: //mail_from.txt//. Specifies the sender of the message. This must be entered using the pattern //Name <user@example.com>// and has no effect on the sending of the message. |
77 |
77 |
Example: {{code language="none"}} [%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com> {{/code}} |
78 |
78 |
|
... |
... |
@@ -80,21
+80,21 @@ |
80 |
80 |
|
81 |
81 |
Für die Konfiguration des E-Mail-Programms sind neben der Adresse des E-Mail-Servers die unter [[Konfiguration des E-Mail-Server-Services>>||anchor="server_config"]] hinerlegten Ports zu verwenden. Die kompletten zu verwendenden Anmeldedaten setzen sich demnach wie folgt zusammen: |
82 |
82 |
|
83 |
|
-; {{smallcaps}}Smtp{{/smallcaps}} server |
84 |
|
-: //<server address>// |
85 |
|
-; {{smallcaps}}Smtp{{/smallcaps}} port |
86 |
|
-: //see//[[Configuration Mail Server Service>>||anchor="server_config"]] |
87 |
|
-; {{smallcaps}}Imap{{/smallcaps}} server |
88 |
|
-: //<server address>// |
89 |
|
-; {{smallcaps}}Imap{{/smallcaps}} port |
90 |
|
-: //see//[[Configuration Mail Server Service>>||anchor="server_config"]] |
91 |
|
-; Username |
92 |
|
-: //<FORMCYCLE-user>@<FORMCYCLE-clientname>// |
93 |
|
-; Password |
94 |
|
-: //<FORMCYCLE-user-password>// |
95 |
|
-; Authentication |
96 |
|
-: Password, normal |
97 |
|
-; SSL encryption and connection security |
|
84 |
+; {{smallcaps}}Smtp{{/smallcaps}} server |
|
85 |
+: //<server address>// |
|
86 |
+; {{smallcaps}}Smtp{{/smallcaps}} port |
|
87 |
+: //see//[[Configuration Mail Server Service>>||anchor="server_config"]] |
|
88 |
+; {{smallcaps}}Imap{{/smallcaps}} server |
|
89 |
+: //<server address>// |
|
90 |
+; {{smallcaps}}Imap{{/smallcaps}} port |
|
91 |
+: //see//[[Configuration Mail Server Service>>||anchor="server_config"]] |
|
92 |
+; Username |
|
93 |
+: //<FORMCYCLE-user>@<FORMCYCLE-clientname>// |
|
94 |
+; Password |
|
95 |
+: //<FORMCYCLE-user-password>// |
|
96 |
+; Authentication |
|
97 |
+: Password, normal |
|
98 |
+; SSL encryption and connection security |
98 |
98 |
: none |
99 |
99 |
|
100 |
100 |
== Example configuration for Thunderbird == |
... |
... |
@@ -103,4
+103,4 @@ |
103 |
103 |
1. Via //account actions// > //add email account...// open the dialog for configuring a new account.{{lightbox image="thunderbird_2.png" group="g0" width="500"/}} |
104 |
104 |
1. Initially, Thunderbird tries to determine a server automatically based on the entered email address (here //user@imap.com//). Since this is not possible here, you can cancel this by clicking the //Edit Manually// button.{{lightbox image="thunderbird_3.png" group="g0" width="500"/}} |
105 |
105 |
1. The corresponding data can now be entered in the following interface of the server configuration. In the example, the client name is //imap.com// and the user name //user// and the standard ports are used.{{lightbox image="thunderbird_4.png" group="g0" width="500"/}} |
106 |
|
-1. After completing the configuration, the user's mailboxes now appear as folders (here //central mailbox// and //demo mailbox//) and contain the messages of the existing form entries.{{lightbox image="thunderbird_5.png" group="g0" width="700"/}}}}} |
|
107 |
+1. After completing the configuration, the user's mailboxes now appear as folders (here //central mailbox// and //demo mailbox//) and contain the messages of the existing form entries.{{lightbox image="thunderbird_5.png" group="g0" width="700"/}} |