Wordpress Plugin: PHPList Integration

PHPList is a excellent open source newsletter manager. However, one missing piece from the application is the ability to cleanly and easily allow users to subscribe to your newsletter from your wordpress blog.

This plugin for wordpress gives you the ability to easily allow users to subscribe to your newsletter from any page on your blog. Simply install the plug-in, configure your settings, and embed the comment <!--phplist form--> on any page on your blog. It's easy and fast.

1. Pre-requisites
2. Quick Start Installation Instructions
3. Detailed Installation Instructions
4. Demo
5. Contact

Pre-requisites

• Wordpress 2.0
• Phplist 2.10.2 (The plug-in may work on versions other then 2.10.2, let me know if you were successful in getting it to work with a previous version)
• PHP 4.x with cURL support

Quick Start Instructions

1. Download plugin installation and upload phplist.php to your plug-ins folder ( /wp-content/plugins)
2. Login to wordpress administration panel and activate the plug-in (Under plug-ins). Plugin name is phplist.
3. Navigate to Options -> PHPLIst and fill in the General Settings configuration as instructed.

Detailed Installation Instructions

1. Download the ZIP installation file, and upload phplist.php to your plug-ins folder ( /wp-content/plugins)
2. Login to wordpress administration panel and activate the plug-in (Under plug-ins). Plugin name is phplist.
3. Click on Options -> PHPlist to configure PHPList
   
   
4. Settings are divided up into General Settings and Form Settings. Starting with General settings, set the following:
   1. PHPList URL: Set this to the url of base installation of the domain where you are hosting PHPList. If the installation folder is password protected then the format of the url should be:
      
      http://username:password@yoursite.com/lists/
      
   2. PHPList Admin Login: Enter the user name of the PHPList Admin. The user/pass of the admin is needed in order to optionally bypass the need to confirm the user.
      
   3. PHPList Admin Password: Enter the password of the PHPList Admin.
      
   4. PHPList List ID: Enter the number of the email list you want to subscribe the user too. To figure out the correct number for your email list, login to PHPList admin and click on Lists for a current list of lists. (http://www.yoursite.com/lists/admin/?page=list) Each list is assigned a number which should be entered in this List ID field.
      
      
      
      
   5. Skip Confirmation Email: Check this option to automatically confirm the user without the need for a confirmation email.
5. The Form Settings shows the two fields available for the subscribe form. The first row is modifiable and allows you to enter any type of text field required. Ideally it should correspond with a field you are already capturing through the Subscriber Page.
   1. Text Label Name: Enter the label of the field that you want to appear on the subscriber form.
   2. Text Field ID: In order to successfully write the field value to the correct value in the PHPList database you have to get the ID of the field from PHPList. Each attribute in PHP takes the form 'attribute[X]' where X is a integer. To determine the corresponding integer go to the Active Subscriber Page within PHPList - http://www.yoursitename.com/lists/admin/?page=spage. Locate the active subscriber page and click edit. Once the subscriber page loads, locate the attribute you are using and find its number:
      
      
   3. Text Field Size: Enter the size of the text field box
   4. Text Field Max Size: Enter the maximum size of the text entered by the user
   5. Required Field: Check this box if the field should be required.