h1. com_connect

h2. Contents

• "Introduction":#introduction
• "Installing and upgrading":#install
• "Migrating from zem_contact_reborn":#differences
• "Usage":#usage
• "Tags":#tags ** "com_connect tag":#cc ** "com_connect_text tag":#cc_text ** "com_connect_email tag":#cc_email ** "com_connect_textarea tag":#cc_textarea ** "com_connect_submit tag":#cc_submit ** "com_connect_select tag":#cc_select ** "com_connect_option tag":#cc_option ** "com_connect_checkbox tag":#cc_checkbox ** "com_connect_radio tag":#cc_radio ** "com_connect_secret tag":#cc_secret ** "com_connect_serverinfo tag":#cc_serverinfo ** "com_connect_send_article tag":#cc_send_article ** "com_connect_mime tag":#cc_mime ** "com_connect_fields tag":#cc_fields ** "com_connect_label tag":#cc_label ** "com_connect_value tag":#cc_value ** "com_connect_if tag":#cc_if
• "Advanced examples":#advanced ** "Separate input and error forms":#advanced1 ** "User selectable subject field":#advanced2 ** "User selectable recipient, without showing email address":#advanced3
• "Styling":#styling
• "Plugin API and callback events":#api
• "Frequently asked questions":#faq
• "Authors/credits":#credits

h2(#introduction). Introduction

A Textpattern CMS form mailer plugin. @<txp:com_connect />@ produces a flexible, customisable email contact form. It is intended for use as an enquiry form for commercial and private sites, and includes several features to help reduce common problems with such forms (invalid email addresses, missing information).

Please report bugs and problems with this plugin at "the GitHub project's issues page":https://github.com/textpattern/com_connect/issues.

h3. Features

• Arbitrary HTML5 text fields can be specified, with min/max/required settings for validation.
• Email address validation, including a check for a valid MX record (Unix only).
• Safe escaping of input data.
• UTF-8 safe.
• Accessible form layout, including @@, @
  @ and @
  @ tags.
• Various classes and ids to allow easy styling of all parts of the form.
• Spam prevention API (used by Tranquillo's @pap_contact_cleaner@ plugin) and delivery API for altering or extending the plugin's capabilities.

h3. History

Please see the "changelog on GitHub":https://github.com/textpattern/com_connect/blob/main/CHANGELOG.textile.

h2(#install). Installing and upgrading

Requires Textpattern 4.7.0+

Download the latest release of the plugin from "the GitHub project page":https://github.com/textpattern/com_connect/releases, paste the code into the Textpattern Admin>Plugins panel, install and enable the plugin. Visit the "forum thread":https://forum.textpattern.io/viewtopic.php?id=47913 for more info or to report on the success or otherwise of the plugin.

To uninstall, delete from the Plugins panel.

Alternatively, this plugin can be installed using "Composer":https://getcomposer.org:

bc(language-bash). $ composer require textpattern/com_connect:*

h2(#differences). Migrating from zem_contact_reborn

If upgrading from zem_contact_reborn (the previous incarnation of this plugin), please note these differences:

• Tags have been globally renamed from @<txp:zem_contact ... />@ to @<txp:com_connect ... />@ - please adjust your code accordingly.
• Classes @zemConnectForm@, @zemError@, @zemRequired@, @zemThanks@, @zemText@, @zemEmail@, @zemTextarea@, @zemSubmit@, @zemSelect@, @zemOption@, @zemCheckbox@ and @zemRadio@ have been renamed to @comConnectForm@, @comError@, @comRequired@, @comThanks@, @comText@, @comEmail@, @comTextarea@, @comSubmit@, @comSelect@, @comOption@, @comCheckbox@ and @comRadio@ respectively - please adjust your code accordingly.
• Disable or remove the zem_contact_lang plugin. Language strings are now bundled as part of the plugin itself. If you have a translation Textpack available that is not yet bundled, please submit it for inclusion.
• Classes based on the input element @name@ are no longer automatically applied. Only default class names beginning with @com@ are set. To employ custom classes, use the @class@ attribute for each tag, or the global @classes@ attribute to set names for error and information messages.
• If your site's 'Doctype' preference is set to @html5@ you may use HTML5 attributes in your tags. Otherwise, they will be ignored.
• Validation of required elements and min/max constraints is done by the browser first, and the plugin second. So if you specify a field is required and it is left empty, the browser will usually prevent the form being submitted. To bypass (most of) the browser checks, specify @browser_validate="0"@ in your @<txp:com_connect />@ tag.

h2(#usage). Usage

h3. Contact form

The simplest form is shown below, which produces a default form with 'Name', 'Email' and 'Message' fields. Email will be delivered to [email protected], with the user's supplied email as the @From:@ address.

bc(language-markup). <txp:com_connect to="[email protected]" />

To specify fields explicitly, use something like this:

bc(language-markup). <txp:com_connect to="[email protected]"> <txp:com_connect_email /> <txp:com_connect_text label="Phone" min="7" max="15" /> <txp:com_connect_textarea label="Your question" /> <txp:com_connect_submit label="Send" /> </txp:com_connect>

Alternatively, place the field specifications in a Textpattern form, and call it like this:

bc(language-markup). <txp:com_connect to="[email protected]" form="my-contact-form" />

h3. Send article

Within the context of an individual article, this plugin can be used to send the article (or excerpt, if it exists) to an email address specified by the visitor. This requires at least two tags:

@com_connect@, to create a form that is initially hidden by setting the @send_article@ attribute.

@com_connect_send_article@, to create a 'Send article' link which reveals the aforementioned form when clicked.

bc(language-markup). <txp:com_connect send_article="1" /> <txp:com_connect_send_article />

By default the form contains fields for your name and email address, the recipient's email address and a personal message, but similar to contact forms you can create your own form layout. Some things you need to know:

Set the @send_article@ attribute to @1@ in the @com_connect@ tag.

Use a @com_connect_email@ tag with the @send_article@ attribute set to @1@. This field will be used as the recipient email address.

bc(language-markup).. <txp:com_connect to="[email protected]" send_article="1"> <txp:com_connect_email label="Recipient Email" send_article="1" /> <txp:com_connect_email label="Your Email" /> <txp:com_connect_submit label="Send Article" /> </txp:com_connect>

<txp:com_connect_send_article />

h2(#tags). Tags

@<txp:com_connect_send_article />@ can be used to create a 'Send article' link within an article form, connecting it to the contact form.

All other tags provided by this plugin can only be used inside a @txp:com_connect@ - @</txp:com_connect>@ container tag or in a Textpattern form used as the @form@ attribute in the @<txp:com_connect />@ tag.

In addition to the tags detailed in the following sections, every tag accepts a core set of common attributes. These are:

; @accesskey="character"@ : Shortcut key to set focus on the field. ; @autofocus="boolean"@ : To automatically focus the cursor in this field on page load. Only one field may have this property. ; @dir="value"@ : Text direction (@ltr@, @rtl@ or @auto@). ; @disabled="boolean"@ : Whether the input control accepts user input. If set, the element does not get submitted with the form, nor is it subject to any @checkValidity()@ JavaScript calls. ; @hidden="boolean"@ : The visibility of the input control. ; @id="id"@ : The HTML identifier for the control. ; @lang="value"@ : The ISO 639 language short code (e.g. @en-gb@, @de-de@) that governs the field. ; @list="id"@ : Used in conjunction with the @

h3(#cc). com_connect tag

bc(language-markup). <txp:com_connect />

May be used as a single (self-closing) or container tag. Place this where you want the input form to go. Status and error messages, if any, will be displayed before the form.

h4. Attributes

; @body_form="form name"@ : Use specified form for the message body text. ; @class="space-separated values"@ : Set the CSS @class@ name of the tag. Default: @comConnectForm@. To remove @class@ attribute from the element entirely, use @class=""@. ; @classes="comma-separated key:value pairs"@ : Set the CSS classes for error / information conditions. Specify each as a pair of values separated by a colon, e.g. @classes="required: req_field, element: warn_field"@. There are up to four available to customise: : @element@: Set for each form field that fails validation for any reason. Default: @errorElement@. : @wrapper@: The class to surround the list of errors shown above the form. Default: @comError@. : @required@: Class assigned when a required element is not completed. Default: @comRequired@. : @thanks@: Class applied to the wrapper around the @thanks_form@. Default: @comThanks@. ; @copysender="boolean"@ : Whether to send a copy of the email to the sender's address. Available values: @1@ (yes) or @0@ (no). Default is @0@. ; @expire="number"@ : Number of seconds after which the form will expire, thus requiring a page refresh before sending. Default is @600@. ; @form="form name"@ : Use specified form, containing the layout of the contact form fields. ; @from="email address"@ : Email address used in the "From:" field when sending email. Defaults to the sender's email address. If specified, the sender's email address will be placed in the "Reply-To:" field instead. ; @from_form="form name"@ : Use specified form (overrides @from@ attribute). ; @label="text"@ : Label for the contact form. If set to an empty string, display of the fieldset and legend tags will be suppressed. Default is @Contact@. ; @lang="lang-code"@ : Override the language strings that would normally be used from the current admin-side language in force. e.g. @lang="fr-fr"@ would load the French language strings. A Textpack must already exist for the chosen language. ; @browser_validate="boolean"@ : Set to 0 if you wish to stop the browser from validating form field values and 'required' status of input elements. The plugin itself is then solely responsible for validation and will indicate error conditions after submission. Default is @1@. ; @redirect="URL"@ : Redirect to specified URL (overrides @thanks@ and @thanks_form@ attributes). URL must be relative to the Textpattern site URL. Example: @redirect="monkey"@ would redirect to @http://example.com/monkey@. ; @replyto=boolean|email address@ : Governs the email address of who the message reply should go to. Options: : @true@ (default): Use the email address from the form itself (value from the @txp:com_connect_email@ tag) if the @from@ address has been specified. Blank otherwise. : @false@: Always use the @from@ email address as reply-to. Note that if the @from@ is omitted the email will be from nobody and may be rejected by the receiving server. : @email address@: Use the specified email address as the reply-to, if it's a valid address. ; @required="boolean"@ : Whether to require all tags in this contact form to be completed before the form can be submitted. Can be overridden on a field-by-field basis by using the @required@ attribute in the relevant tag. Available values: @1@ (yes) or @0@ (no). Default is @1@. ; @send_article="boolean"@ : Whether to use this form to send an article. Available values: @1@ (yes) or @0@ (no). Default is @0@. ; @show_error="boolean"@ : Whether to display error and status messages. Available values: @1@ (yes) or @0@ (no). Default is @1@. ; @show_input="boolean"@ : Whether to display the form @@ fields. Available values: @1@ (yes) or @0@ (no). Default is @1@. ; @subject="subject text"@ : Subject used when sending an email. Default is the site name. ; @subject_form="form name"@ : Use specified form (overrides @subject@ attribute). ; @thanks="text"@ : Message shown after successfully submitting a message. Default is @Thank you, your message has been sent@. ; @thanks_form="form name"@ : Use specified form (overrides @thanks@ attribute). ; @to="email address"@ %(warning)required% : Recipient email address. Multiple recipients can be specified, separated by commas. ; @to_form="form name"@ : Use specified form (overrides @to@ attribute).

h4. Examples

h5. Example 1: Built-in contact form

When used as a single tag, produces a default form with 'Name', 'Email' and 'Message' fields. Email will be delivered to [email protected], with the user's supplied email as the @From:@ address:

bc(language-markup). <txp:com_connect to="[email protected]" />

h5. Example 2: Building a custom form container

When used as a container tag, much more flexibility is allowed, for example:

bc(language-markup). <txp:com_connect to="[email protected]"> <txp:com_connect_email /> <txp:com_connect_text type="tel" label="Phone" min="7" max="15" /> <txp:com_connect_textarea label="Your question" /> <txp:com_connect_submit label="Send" /> </txp:com_connect>

h5. Example 3: Custom message formatting

Use the @body_form@ attribute to build custom content that is emailed to the recipient:

bc(language-markup). <txp:com_connect to="[email protected]" body_form="message-formatting" />

And the @body_form@ form template named @message-formatting@ is as follows:

bc.. ============ Email received.

<txp:com_connect_if name="email"><txp:com_connect_label name="email" />: <txp:com_connect_value name="email" /><txp:else />Mr. Nobody</txp:com_connect_if> wrote:

<txp:com_connect_if name="message"><txp:com_connect_value name="message" /><txp:else />Nothing much :(</txp:com_connect_if>

============

h5. Example 4: HTML and plaintext email content

Use the @body_form@ attribute to build custom content in both plaintext and HTML formats that is emailed to the recipient:

bc(language-markup). <txp:com_connect to="[email protected]" body_form="message-formatting" />

Use the @body_form@ form template named @message-formatting@ as follows, and note the @txp:com_connect_mime@ tags which indicate that the content of the given @type@ immediately follows. Use the tag with @type="end"@ to signify that the content is complete.

bc.. ============ <txp:com_connect_mime type="text" /> Fields submitted: <txp:com_connect_fields break=""> <txp:com_connect_label />: <txp:com_connect_value /> </txp:com_connect_fields>

<txp:com_connect_mime type="html" />

<txp:com_connect_mime type="end" />

h3(#cc_text). com_connect_text tag

bc(language-markup). <txp:com_connect_text />

Creates a text @@ field and corresponding @@ tag. The input value will be included in the email, preceded by the label.

h4. Attributes

; @autocomplete="value"@ : Indicates whether the value of the control can be automatically completed by the browser. This attribute is ignored if the value of the type attribute is @password@. Possible values are: @off@ (the browser does not automatically complete the entry) or @on@ (the browser can automatically complete the value based on values that the user has entered during previous uses). Default is unset. ; @break="tag"@ : Break tag between the @@ and @@ field. Default is @
@. Use @break=""@ to put the label and input field on the same line. ; @class="space-separated values"@ : Set the CSS @class@ name of the tag. Default: @comText@. To remove @class@ attribute from the element entirely, use @class=""@. ; @default="value"@ : Default value when no input is provided. ; @html_form="id"@ : The HTML @id@ of the @

h4. Examples

h5. Example 1: Text input box

bc(language-markup). <txp:com_connect_text label="Your name" />

h5. Example 2: Range slider

bc(language-markup). <txp:com_connect_text type="range" label="UK shoe size" min="1" max="15" />

h5. Example 3: Telephone input with validation

Create a telephone field with a "validation pattern for UK telephone number":http://html5pattern.com/Phones format:

bc(language-markup). <txp:com_connect_text type="tel" label="Telephone" pattern="^\s*(?(020[7,8]{1})?[ ]?[1-9]{1}[0-9{2}[ ]?[0-9]{4})|(0[1-8]{1}[0-9]{3})?[ ]?[1-9]{1}[0-9]{2}[ ]?[0-9]{3})\s*$" required="1" />

h3(#cc_email). com_connect_email tag

bc(language-markup). <txp:com_connect_email />

@@ field for user's email address.

The entered email address will automatically be validated to make sure it is of the form "[email protected][.zzz]". On non-Windows servers, a test will be done to verify that an A or MX record exists for the domain. Neither test prevents spam, but it does help detect accidental typing errors.

h4. Attributes

; @autocomplete="value"@ : Indicates whether the value of the control can be automatically completed by the browser. Possible values are: @off@ (the browser does not automatically complete the entry) or @on@ (the browser can automatically complete the value based on values that the user has entered during previous uses). Default is unset. ; @break="tag"@ : Break tag between the @@ and @@ field. Default is @
@. Use @break=""@ to put the label and input field on the same line. ; @class="space-separated values"@ : Set the CSS @class@ name of the tag. Default: @comEmail@. To remove @class@ attribute from the element entirely, use @class=""@. ; @default="value"@ : Default value when no input is provided. ; @html_form="id"@ : The HTML @id@ of the @

h4. Examples

h5. Example 1: Standard email field

bc(language-markup). <txp:com_connect_email label="Your email address" />

h3(#cc_textarea). com_connect_textarea tag

bc(language-markup). <txp:com_connect_textarea />

Creates a @@.

h4. Attributes

; @autocomplete="value"@ : Indicates whether the value of the control can be automatically completed by the browser. Possible values are: @off@ (the browser does not automatically complete the entry) or @on@ (the browser can automatically complete the value based on values that the user has entered during previous uses). Default is unset. ; @break="tag"@ : Break tag between the @@ and @@. Default is @<br>@. Use @break=""@ to put the @<label>@ and @<input>@ field on the same line. ; @class="space-separated values"@ : Set the CSS @class@ name of the @<textarea>@. Default: @comTextarea@. To remove @class@ attribute from the element entirely, use @class=""@. ; @cols="integer"@<br>Number of columns, in characters, of the @<textarea>@. Default is @58@. ; @default="value"@ : Default value when no input is provided. ; @html_form="id"@ : The HTML @id@ of the @<form>@ tag to which the @<textarea>@ is attached. Associated with the contained form by default. ; @label="text"@ : Text label displayed to the user. Default is @Message@. ; @label_position="text"@ : Position of the label in relation to the @<textarea>@ field. Available values: @before@ or @after@. Default is @before@. ; @max="integer"@ : Maximum input value length in characters, using the HTML5 @maxlength@ attribute. Default is @10000@. To remove @maxlength@ attribute from the element entirely (not recommended), use @max=""@. ; @min="integer"@ : Minimum input value length in characters, using the HTML5 @minlength@ attribute. Default is unset, i.e., no minimum limit. ; @name="value"@ : Field name, as used in the HTML @<input>@ tag. ; @placeholder="text"@ : Text to show as a guide to users, when the @<textarea>@ is empty. ; @required="boolean"@ : Whether this field must be filled out. Available values: @1@ (yes) or @0@ (no). Default is whatever is set in the @<span>txp:com_connect</span>@ tag's @required@ attribute - if neither attribute is set then default is @1@. ; @rows="integer"@ : Number of rows, in characters, of the @<textarea>@. Default is @8@. ; @wrap="value"@ : Governs word-wrap. Available values: @hard@ or @soft@. If this attribute is not specified, @soft@ is its default value.

h4. Examples

h5. Example 1: Standard textarea

Create a text area that is 40 characters wide, 10 lines high, with a customised label:

bc(language-markup). <txp:com_connect_textarea cols="40" rows="10" label="Your question" />

h3(#cc_submit). com_connect_submit tag

bc(language-markup). <txp:com_connect_submit />

Creates a submit button. When used as a container tag, a @@ element will be used instead of an @@ element.

h4. Attributes:

; @class="space-separated values"@ : Set the CSS @class@ name of the tag. Default: @comSubmit@. To remove @class@ attribute from the element entirely, use @class=""@. ; @html_form="id"@ : The HTML @id@ of the @

h4. Examples

h5. Example 1: Single drop-down select list

A list labeled 'Department', containing three options and a blank option shown by default and labelled with 'Choose dept', forcing the user to make a selection.

bc(language-markup). <txp:com_connect_select label="Department" options="{Choose dept},Marketing,Sales,Support" />

h5. Example 2: Using the com_connect option tag

Same as the above example, but with 'Sales' selected by default.

bc(language-markup). <txp:com_connect_select label="Department" selected="Sales"> <txp:com_connect_option label="{Choose dept}" /> <txp:com_connect_option label="Marketing" /> <txp:com_connect_option label="Sales" /> <txp:com_connect_option label="Support" /> </txp:com_connect_select>

The advantage to use the option tag is that you can name the options independently of the label. You could also add a boolean @selected@ attribute to the individual option tag, instead of to the containing select tag.

h5. Example 3: Multiple select

bc(language-markup). <txp:com_connect_select label="Ice cream flavours" multiple> <txp:com_connect_option label="{Choose your favourites}" /> <txp:com_connect_option label="Vanilla" /> <txp:com_connect_option label="Strawberry" /> <txp:com_connect_option label="Raspberry" /> <txp:com_connect_option label="Chocolate" /> <txp:com_connect_option label="Mint choc-chip" name="mint-with-chocolate-chips" /> </txp:com_connect_select>

h3(#cc_option). com_connect_option tag

bc(language-markup). <txp:com_connect_option />

Creates a drop-down selection option. May be used as a single (self-closing) or container tag. Also see @com_connect_select@ tag above.

h4. Attributes

; @class="space-separated values"@ : Set the CSS @class@ name of the option. Default: @comOption@. To remove @class@ attribute from the element entirely, use @class=""@. ; @label="text"@ %(warning)required% : Text label of this option displayed to the user. Surround the label with {braces} to indicate it is an empty placeholder at the start of the list. Note if you use this braces syntax, the value will be forced to @value=""@, i.e. any supplied value will be ignored. ; @selected="boolean"@ : Whether this item is selected, May also be specified in the container tag's @selected@ attribute. Available values: @1@ (yes) or @0@ (no). ; @value="text"@ : The value associated with this option when submitted. Default is the label.

h5. Example 1: Drop-down select list containing three options

bc(language-markup). <txp:com_connect_select label="Department"> <txp:com_connect_option label="Marketing" /> <txp:com_connect_option label="Sales" /> <txp:com_connect_option label="Support" /> </txp:com_connect_select>

h5. Example 2: Pass different values instead of label

'Sales' is selected by default.

bc(language-markup). <txp:com_connect_select label="Department"> <txp:com_connect_option value="contact-marketing">Marketing</txp:com_connect_option> <txp:com_connect_option value="contact-sales" selected>Sales</txp:com_connect_option> <txp:com_connect_option value="contact-support">Support</txp:com_connect_option> </txp:com_connect_select>

h3(#cc_checkbox). com_connect_checkbox tag

bc(language-markup). <txp:com_connect_checkbox />

Creates a checkbox.

h4. Attributes

; @break="tag"@ : Break tag between the checkbox button and label. Default is one space. Use @break="br"@ to put the checkbox and label on separate lines. ; @checked="boolean"@ : Whether this box is checked when first displayed. Available values: @1@ (yes) or @0@ (no). Default is @0@. ; @class="space-separated values"@ : Set the CSS @class@ name of the option. Default: @comCheckbox@. To remove @class@ attribute from the element entirely, use @class=""@. ; @html_form="id"@ : The HTML @id@ of the @

For reference here are the commands that will be interesting to plugin developers:

bc(language-php).. // This will call your function before the form is submitted so you can analyse the submitted data register_callback('abc_myfunction', 'comconnect.submit');

// This will call your function and add the output (use @return $mystuff;@) to the contact-form. register_callback('abc_myotherfunction2', 'comconnect.form');

// To get hold of the form-variables you can use global com_connect_form; // With the following two lines you can tell com_connect if your plugin found spam. $evaluator =& get_comconnect_evaluator();

// The passed value must be non-zero to mark the content as spam. // Value must be a number between 0 and 1. $evaluator -> add_comconnect_status(1);

p. Multiple plugins can be active at the same time and each of them can mark the submitted content as spam and prevent the form from being submitted.

h4. Examples

bc(language-php).. register_callback('pap_comconnect_form','comconnect.form'); register_callback('pap_comconnect_submit','comconnect.submit');

function pap_comconnect_form() { $field = '

function pap_comconnect_submit() { $checking_mail_field = trim(ps('mail')); $checking_phone_field = trim(ps('phone')); $evaluation =& get_comconnect_evaluator();

// If the hidden fields are filled out, the contact form won't be submitted!
if ($checking_mail_field != '' or $checking_phone_field != '') {
    $evaluation -> add_comconnect_status(1);
}

return;

}

p. For the delivery callback, you signal back to the plugin your intentions so that com_connect knows what to do after your delivery plugin has executed. Return the following strings:

• @comconnect.send@ (or no return value) to allow com_connect to continue mailing the content.
• @comconnect.skip@ to skip com_connect's mailing (i.e., the third party handles the mail process) and return 'success' to the visitor.
• @comconnect.fail@ to skip com_connect's mailing and return 'fail' to the visitor.

Or simply @exit@ your plugin to halt the entire operation so no com_connect feedback is given.

h2(#faq). Frequently asked questions

h5. How do I remove the legend and fieldset surrounding the contact form?

Set the @label@ attribute to an empty value (@label=""@) in the @com_connect@ tag.

h5. No email is sent. How do I diagnose and fix the problem?

First try a simple contact form, using only the @com_connect@ tag with the @to@ attribute set to a valid email address. If that doesn't send email, fill out the 'SMTP envelope sender address' field in Textpattern's Admin>Preferences. If that doesn't help either, take a look at your mail server log files to see what the problem is.

h5. Which tag do I use to create the submit button?

Just use normal HTML code to create a submit button. For historical reasons this plugin still provides the @com_connect_submit@ tag, but it provides little extra functionality.

h5. How can I get a unique (order) number in the subject of each email?

Try using the "rvm_counter":http://vanmelick.com/txp tag in the @subject@ attribute of the @com_connect@ tag.

h5. I want to use the contact form in an article list (one form for each article), but how do I make each form unique?

You can make each form unique by making one of its attribute values unique. See previous question for an example of how to do this with the @subject@ attribute.

h5. Send article: can I let people specify multiple recipients?

No. The 'send article' functionality is spammy enough as it is right now.

h5. Send article: can I show the contact form without having to click a link first?

Sure, put this just above the @com_connect@ tag:

bc(language-markup). txp:php$_GET['com_connect_send_article']='yes';</txp:php>

h5. How can I use this form to upload files?

You can't, but have a look at the "ext_file_attach":https://github.com/Bloke/ext_file_attach/releases/ module, or "mem_form":https://bitbucket.org/Manfre/txp-plugins/downloads/ plugins.

h5. Can I use this plugin to send HTML email?

Yes.

h5. Can I use this plugin to send newsletters?

Not without a plugin, such as "mem_postmaster":https://bitbucket.org/Manfre/txp-plugins/downloads/.

h5. I have a question that's not listed here

First read the plugin documentation (the page you're on right now) once more. If that doesn't answer your question, visit the "Textpattern forum":https://forum.textpattern.io.

h2. Authors/credits

• zem wrote the zem_contact 0.6 plugin on which this plugin was initially based.
• Mary completely revised the plugin code.
• Stuart turned it into a plugin, added a revised help text and additional code. Maintained all plugin versions until 4.0.3.17.
• wet added the @com_connect_radio@ tag.
• Tranquillo added the anti-spam API and @zem_contact_send_article@ functionality.
• aslsw66, jdykast and others provided additional code.
• Ruud cleaned up and audited the code to weed out bugs and completely revised the help text. Maintained all versions until 4.0.3.20.
• Bloke was the maintainer of v4.5.0.0.
• Adopted as a community plugin and now maintained by the core development team.
• Supported and tested to destruction by the Textpattern community. Many thanks to "all additional contributors":https://github.com/textpattern/com_connect/graphs/contributors.