Diff for "DOC/4.33 How do I put a subscribe form for my list on a web page?"

Differences between revisions 1 and 6 (spanning 5 versions)

4.33. How do I put a subscribe form for my list on a web page?

Cut and paste the code below into the HTML of your web page. Replace XYZ with the name of your list and adjust the action= URL as required for your mailman installation.

The only required parts of this form are the email text box and the submit button - edit or remove the others as you like.

Beginning with Mailman 2.1.16, a site can choose to add a dynamically generated hidden hash to the subscribe form. If that is done, static forms such as below will not work. See the information in Defaults.py for the SUBSCRIBE_FORM_SECRET setting for more information.

 <h2>Join the XYZ list</h2>

 <form method="post" action="http://example.org/mailman/subscribe/XYZ">
  Your E-mail address: <input name="email"> Your Name (optional):
  <input name="fullname">

  <p>You may enter a privacy password below. This provides only
  mild security, but should prevent others from messing with your
  subscription. <strong>Do not use a valuable password</strong> as
  it will occasionally be emailed back to you in cleartext. If you
  choose not to enter a password, one will be automatically
  generated for you, and it will be sent to you once you've
  confirmed your subscription. You can always request a mail-back
  of your password when you edit your personal options.</p>

  <p>Password choice: <input type="password" name="pw"> Confirm
  Password: <input type="password" name="pw-conf"></p>

  <p>Would you like to receive list mail batched in a daily digest?
  (You may choose NoMail after you join.) <input type="radio" name=
  "digest" value="0" checked> No <input type="radio" name="digest"
  value="1"> Yes</p>

  <p><input type="submit" name="email-button" value=
  "Subscribe"></p>
  </form>

Converted from the Mailman FAQ Wizard

This is one of many Frequently Asked Questions.

MailmanWiki: DOC/4.33 How do I put a subscribe form for my list on a web page? (last edited 2012-11-24 15:05:23 by msapiro)

-  ⇤ ← Revision 1 as of 2008-07-31 13:58:20 → 
  Size: 1869
  Editor: dunxd
  Comment:
+   ← Revision 6 as of 2012-11-24 15:05:23 → ⇥
  Size: 2005
  Editor: msapiro
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-#pragma page-filename DOC/versions/5865496
+#pragma page-filename DOC/versions/4030596
 Line 3:
-Cut and paste the code below into the HTML of your web page.
+Cut and paste the code below into the HTML of your web page. Replace XYZ with the name of your list and adjust the action= URL as required for your mailman installation.
-Line 7:
+Line 8:
-{{{
 &lt;h2&gt;Join the XYZ list&lt;/h2&gt;
+{{{#!wiki caution

Beginning with Mailman 2.1.16, a site can choose to add a dynamically generated hidden hash to the subscribe form. If that is done, static forms such as below will not work. See the information in Defaults.py for the SUBSCRIBE_FORM_SECRET setting for more information.
-Line 11:
+Line 13:
+{{{
 <h2>Join the XYZ list</h2>
-Line 12:
+Line 16:
-{{{
 &lt;form method="post" action=
 "http://example.org/mailman/subscribe/XYZ"&gt;
  Your E-mail address: &lt;input name="email"&gt; Your Name (optional):
  &lt;input name="fullname"&gt;
}}}
+ <form method="post" action="http://example.org/mailman/subscribe/XYZ">
  Your E-mail address: <input name="email"> Your Name (optional):
  <input name="fullname">
-Line 19:
+Line 20:
-{{{
  &lt;p&gt;You may enter a privacy password below. This provides only
+  <p>You may enter a privacy password below. This provides only
-Line 23:
+Line 22:
-  subscription. &lt;strong&gt;Do not use a valuable password&lt;/strong&gt; as
+  subscription. <strong>Do not use a valuable password</strong> as
-Line 28:
+Line 27:
-  of your password when you edit your personal options.&lt;/p&gt;
+  of your password when you edit your personal options.</p>

  <p>Password choice: <input type="password" name="pw"> Confirm
  Password: <input type="password" name="pw-conf"></p>

  <p>Would you like to receive list mail batched in a daily digest?
  (You may choose NoMail after you join.) <input type="radio" name=
  "digest" value="0" checked> No <input type="radio" name="digest"
  value="1"> Yes</p>

  <p><input type="submit" name="email-button" value=
  "Subscribe"></p>
  </form>
-Line 31:
+Line 42:
+Converted from the Mailman FAQ Wizard
-Line 32:
+Line 44:
-{{{
  &lt;p&gt;Password choice: &lt;input type="password" name="pw"&gt; Confirm
  Password: &lt;input type="password" name="pw-conf"&gt;&lt;/p&gt;
}}}


{{{
  &lt;p&gt;Would you like to receive list mail batched in a daily digest?
  (You may choose NoMail after you join.) &lt;input type="radio" name=
  "digest" value="0" checked&gt; No &lt;input type="radio" name="digest"
  value="1"&gt; Yes&lt;/p&gt;
}}}


{{{
  &lt;p&gt;&lt;input type="submit" name="email-button" value=
  "Subscribe"&gt;&lt;/p&gt;
  &lt;/form&gt;
}}}

''Last changed on Mon Feb 11 05:16:27 2008 by'' Mark Sapiro
<<Color2(Converted from the Mailman FAQ Wizard, col=darkgreen)>>This is one of many [[../Frequently Asked Questions|Frequently Asked Questions]].
+This is one of many [[../Frequently Asked Questions|Frequently Asked Questions]].