CiviCRM Components

Tools for engaging your supporters...

CiviContribute


CiviEvent


CiviMail


CiviMember


Submitted by shot on Mon, 2008-11-03 09:00.

The idea of creating a Drupal block containing a subscription form for a specific CiviMail mailing list (or for all of them) comes regularly on the forum, so I decided to try out how much work would it be to create one.

It turns out this task is fairly simple, if one knows the proper URLs for CiviMail subscription pages. The URLs are of the form …civicrm/mailing/subscribe?reset=1 (for all mailing lists) and …civicrm/mailing/subscribe?reset=1&gid=X (for a mailing list with group id of X). For example, these two URLs point to subscription pages on our Drupal demo installation: http://drupal.demo.civicrm.org/civicrm/mailing/subscribe?reset=1 (all mailing lists), http://drupal.demo.civicrm.org/civicrm/mailing/subscribe?reset=1&gid=2 (the Newsletter Subscribers list).

If having a separate page is not really the best outcome, there’s a possibility of creating similar Drupal blocks. The simplest(?) way of doing this is to look at the sources of the above pages, strip them down as much as necessary and then create an HTML Dupal block from the resulting code.

From my quick try, it seems like the below is a nice starting point (for a block listing all groups) – of course, in your case you need to adjust the URL, the names of the lists and their respective ids:

<form action="http://drupal.demo.civicrm.org/civicrm/mailing/subscribe" method="post">
  <p>Email: <input name="email" type="text" id="email" /></p>
  <table>
    <tr>
      <td><input name="mark_x_4" type="checkbox" value="1" /></td>
      <td>Advisory Board</td>
    </tr>
    <tr>
      <td><input name="mark_x_2" type="checkbox" value="1" /></td>
      <td>Newsletter Subscribers</td>
    </tr>
    <tr>
      <td><input name="mark_x_3" type="checkbox" value="1" /></td>
      <td>Summer Program Volunteers</td>
    </tr>
  </table>
  <p>
    <input name="_qf_Subscribe_next" value="Subscribe" type="submit" />
  </p>
</form>

Creating a block for just a single list subscription is even easier – all you need to do is to pass the id as a hidden field:

<form action="http://drupal.demo.civicrm.org/civicrm/mailing/subscribe" method="post">
  <p>
    Email: <input name="email" type="text" id="email" />
    <input type="hidden" name="mark_x_2" value="1" />
    <input name="_qf_Subscribe_next" value="Subscribe" type="submit" />
  </p>
</form>

If you have any comments or questions on the above, please feel free to join this thread on our forum.

( categories: )

redirect?

This is great, thank you for posting this. However, how do you set the "redirect" page (to where you want the person to be redirected to) once the subscriber confirms their subscription from the confirmation email? Also, is it possible to collect additional information, i.e. subscribers zip code?

Best to repost these

Best to repost these questions on the community forum - CiviMail section:

http://forum.civicrm.org/index.php/board,17.0.html

beware

Be aware that by doing it this way (pasting an entire HTML form into a block) you are bypassing Drupal's FormAPI and all the security that goes along with it...

-mike

yes, but this form is being handled by a civicrm action ..

and civicrm takes care of form validation and escaping charaters etc within its form processing framework (which is different from drupal's form api)

lobo