Skip to content


Konzern Theme: Adding a News Subscription Form with mlm

Letting the user sign up a newsletter is a vital step in online marketing. I am using MaxBulk Mailer to send out mails to my customers and I stumbled over a great and free script called mlm (Mailing List Manager) from MaxProg. Even it can be used alone, its full strength lies in the combination of that script and MaxBulk Mailer, as it is integrated in the mailer application, so you don’t have to export/import mail lists. Note that the script itself is free but if you are using it on commercial sites you have to purchase a pro license for USD $10. To learn more about the mlm script, you can go to the mlm page on maxprogs website:
http://www.maxprog.com/site/scripts/list_manager/index.html
What I did was changing some code in the script, so the subscription is handled in the background via ajax. This means that the user won’t be redirected to a separate page when submitting the form but gets a status notification dynamically below the form.

What you need to be able to use the mlm script

1. PHP Support: To use the script you need PHP support on your webserver. If you are not sure if PHP is supported, please contact your hosting provider. To test the availability, you can also create a simple contact form in RW, upload it and see if it works. If it does, your webserver does include PHP support.
2. FTP Client: You will also need any FTP client to upload the needed files and change the file/folder access rules. You could add the needed files as page assets to an RW page, but then you are limited to that page only and you can’t change the file/folder info – which may result in a non-working installation.
3. MySQL Database (optional): You can use a mysql db if you like. In general mlm works with flat files, but if you prefer using a database, you can set this option in the config file (described later in this chapter)

Installation and General Usage

I am not going to describe the whole installation process here, as all information is already available in the included mlm_readme.html file. I think everything is described well in that manual. If you should have questions, please use the forum of maxprog to get further instructions or support:
http://www.maxprog.com/forum/forum-15.html
The folder you need to upload is the "mlm" folder in the expanded and downloaded mlm snippet folder.

Adding the Subscription Form to your Pages

mlm_Snippet.png

In the downloaded and expanded mlm_snippet folder you will find two snippets to make integrating the news signup form very easy. To use the snippets, you first need to install them by double clicking the .rwsnippet files.
When you installed the snippets you will find them in the Snippets window in RapidWeaver. To bring this window to the front, select Show Snippets from the View menu.
To add a working sign up form to your page, just drag the snippets to the following fields:

1. Ajax Sign Up Form (JS) to the JavaScript Field in the page inspector (Header tab)
2. Ajax Sign Up Form (HTML) to any content field you want to show your form. I use the sidebar content for myself, but you can also just drag it into the content window

Note that if you are using styled text for the content where you put the Ajax Sign Up Form HTML code you have to mark the code and choose Ignore Formatting from the Format menu to work.

Adjusting the Form Submission Code

Ajax_HTML_mlm_Code.png

The last step to make the form work is to adjust some values in the HTML code. Here are the values to change:
YOURDOMAIN.com: Set the URL to where you uploaded the mlm folder during the installation
value="News": You may set the list title here (probably you don’t need to change it, as it will be a news mailing list. But you may give any other title here (e.g. Product Announcements, Beta List, …). You can also add different mailing lists to different pages. You can have a General Info List on one page and a Product Update List on another page. So, you can adjust the target list titles with the value here.
You probably also want to change other text in the form. I think it is quiet clear where to change what. But don’t change any name values to the form fields (e.g. firstname)!

How to Adjust the Returned Text

If you want to change the text below the form after the submission, you have to dig into the mlm.php file. Open the file in any simple text editor and search for the string to replace. In general there is no need to change it. But in case you want, I told you where to search for it ;-)

Tags:, , , , , , ,

One Response

Stay in touch with the conversation, subscribe to the RSS feed for comments on this post.

  1. Keith Baldwin says

    This is an excellent subscription form. Unfortunately, I can’t seem to make it work properly on my website’s blog page. I have had several back and forth postings with (site administrator) stanbusk at Maxprog and so far he has been unable to help me fix the problem with the subscription form.

    Before contacting Maxprog for help, I added your script and html code snippets to my page inspector and republished my site. But after clicking on the submit button nothing happens. I also did not get the status notification dynamically below the form. The instructions that I received from stanbusk at Maxprog was to add some php code at the beginning of the page and remove the javascript code snippet. I did that and clicked on the submit button and this time the information that I typed into the form disappeared and the URL in the address bar changed, but it still didn’t redirect me to the confirmation page and send me an email (per the Maxprog manual instructions). Has anyone else wrote you with a similar problem? I really want to use this form and MaxBulk Mailer, but I need to resolve this issue before I can move forward.

    I’m using RapidWeaver 4.2.1 and my php version is 5.0 (Siteground).

    Thank you,
    K. Baldwin



Some HTML is OK

or, reply to this post via trackback.