Home Products Downloads News Store Support

Maxprog Logo  

Maxprog Scripts

Mailing List manager User Guide

User Guide
Main Page | User Guide | Installation | FAQ | Forum
Maxprog Mailing List Manager (MLM for short) is a double opt-in list subscription manager and a message opening/click-through tracking PHP script you can install on your web site and start using in minutes. MLM supports a full set of commands you can use either directly with your web browser or with MaxBulk Mailer. You can set MLM to work with either a mySQL database or simple raw text files just changing a parameter in the settings file.


MLM can be installed both manually or using MaxBulk Mailer (v7 or higher).

New paragraph With MaxBulk Mailer (v7 or higher) just select the 'MaxBulk Mailer > Install MLM…' menu. A step by step installation tutorial is available here. On the first panel you can enter your MLM settings, your user ID, password, installation type and so on. By clicking on the 'Next' button you can enter your FTP server information filling the different fields on screen, host address, user ID, password and so on ('Path' refers to the folder where all your public stuff is already located, it can be 'public', 'html', 'public_html', 'web', 'www', 'httpdocs' ...etc... or nothing at all - 'Web URL' refers to the web URL of your site e.g. 'http://www.mysite.com/'). Once you are done with those two previous steps you can click again on the 'Next' button in order to connect to your server. Then select the destination folder or create a new one. Click on the 'Select' button after either selecting or opening a destination folder. MaxBulk Mailer will then install MLM on that folder for you. Never install MLM into your home root folder if you have a specific folder for public html documents like 'public', 'html', 'public_html', 'web', 'www', 'httpdocs'. Just open that folder and any subfolder first! All those topics and some more are covered in MLM FAQ.

New paragraph If you prefer to install MLM manually (or because the MaxBulk Mailer built-in installer failed), don't worry, it is very simple. You just need to go through the following steps:

     1.- Open the lm/lm_settings.php file with a text editor.
     2.- Edit the script settings and save.
     3.- Upload the 'lm' folder to your FTP server (in your public folder).
     4.- Use your FTP software to CHMOD the 'lm' folder to 777 (or 775, 755 or 705).
     5.- Enter the 'lm.php' full URL and your user ID and password to MaxBulk preferences.
     6.- If you have selected to use mySQL run the script with the 'Init' command:

Note: The lm/lm_settings.php contains all the parameters you can change to customize the script to match your needs. When doing a manual installation it is important to open that file with a plain text editor like Notepad on Windows or TextEdit on the Macintosh. If you don't know how to CHMOD a folder with your FTP software please read your FTP software manual or use MaxBulk Mailer built-in installation instead. It is possible your server doesn't like you to CHMOD the 'lm' folder to 777 (showing an 'Internal Server Error' when you try to run the script with your browser) so just try 775, 755 or 705. The HTML folder includes a few sample pages for subscribing customers to your lists (to a fixed single list, a single list from a selection or multiple lists at once) and a sample page for uploading lists to MLM (Pro version only). Never upload MLM to your home root folder if you have a specific folder for public html documents like 'public', 'html', 'public_html', 'web', 'www', 'httpdocs'. Just open the folder or any subfolder first!


If you are using raw text files rather than mySQL to store your data it is highly recommended to rename the mlm main folder and the different subfolders used by the script. In fact, other MLM users might know how to find your files and could easily steal them. Do your best to make it as difficult as possible. You may also add an index.html or modify .htaccess on each folder to prevent listing. This is done automatically since MLM v2.0 for most folders. You will find more info on this topic in the lm_settings.php file. You will not have this problem if you use mySQL.

Important: For security reasons, if you have imported lists using the 'Import' function remember to delete them once you are finished. The script can't do it for you because of the file permissions.

MLM fully integrates with MaxBulk Mailer (v6 or higher) through the 'Remote Lists' function allowing you to send messages to your remote lists directly as if they were local, without the need to go through the tedious and boring import/export steps. The 'Remote Lists' option is a new entry available in the List Manager pull-down menu, just below 'Multiple Lists'. In addition MLM also allows you to track message opening and link click-through with the help of MaxBulk Mailer (v7 Pro or higher). You just need to activate click-through tracking and send your message with MaxBulk Mailer. Then you can follow all your recipients actions through the MaxBulk Mailer statistics window.

Commands (Optional reading)

Actually you don't have to use the following MLM commands, you don't even need to know about them at all. We provide the documentation below in case you are creating your own interface. Indeed MaxBulk Mailer handles everything for you automatically as soon as you have entered the 'lm.php' URL and your password into the preferences. If you need a subscription page on your web just use or modify any of the templates that comes with MLM in the 'lm/html' folder.

All MLM commands can be issued through a Web Browser or through a link on email messages. Some of those commands are intended to be used by the subscribers and others by the administrator (you). A subscriber can get the list of available lists, subscribe to a list or unsubscribe from a list. In addition the administrator can also create a list, remove a list, get the contents of one or several lists and get info about the server. Administrator commands are protected with a password.

A command is made of parameters, 'cmd' is the command name and it is required. 'list' is the list name(s), 'email' is the email address involved in the command and 'pwd' is the administrator password. Optional parameters (or parts) are enclosed into brackets. Remove the brackets to include a parameter or remove the parameter and its brackets if you don't want to use it. Do not use a command with optional parameters enclosed into brackets. All commands are delimited with an ampersand but the first one. In fact the script name 'lm.php' is separated from its parameters with an interrogation sign. There is no specific order for parameters. Parameter '&list=list1[&list2;...]' means you can place one or several lists separated with a semicolon. Some optional parameters can change the command functionality.

All supported commands are listed below:

New paragraph Subscribing
New paragraph This command when used without the administrator password lets a visitor subscribe himself to one or several lists. When used with the administrator password the command forces the direct subscription of an address to one or several lists bypassing the double opt-in mechanism.

New paragraph Unsubscribing
New paragraph This command when used without the administrator password lets a visitor unsubscribe himself from one or several lists. When used with the administrator password the command forces the direct unsubscription of an address from one or several lists bypassing the double opt-in mechanism. If no list is submitted the email address will be unsubscribed from all lists.

New paragraph Updating a recipient
New paragraph This command allows the administrator to update the recipient with the given email address from the given list(s). You can update fields like 'firstname', 'lastname', 'company'...etc...

New paragraph Getting the available lists
New paragraph This command when used without the administrator password lets a visitor find out which lists he is subscribed to. When used with the administrator password the command returns detailed information of all lists available on the server, including each list name, recipient count and modification date.

New paragraph Initializating (mySQL only)
New paragraph This command allows the administrator to create, if they don't exist, the mySQL database and the list table following the mlm settings file. It is required to run this command once only if you are using mySQL to store your lists.

New paragraph Getting a subscriber list
New paragraph This command lets the administrator download one or several lists. If you are issuing the command with a web browser, the default output is the current web document. However, you can redirect the output to a file adding the '&output=file' parameter.

New paragraph Creating lists
New paragraph This command allows the administrator to create a new list when using text files for list storage. This command is not required as lists are automatically created by commands involving them. If you use mySQL this command will simply create the database and the table (same as Init command).

New paragraph Removing lists
New paragraph This command allows the administrator to remove one or several lists. This command should be used with extreme care as deleted lists are not recoverable.

New paragraph Renaming a list
New paragraph This command allows the administrator to rename a list. This command should be used with extreme care since you have to update any HMTL form you have created with the new list name.

New paragraph Getting info
New paragraph This command allows the administrator to get valuable info about the server and the script status. It returns the PHP version and the mySQL version if mySQL is being used.

New paragraph Uninstall
New paragraph This command allows the administrator to remove all the folders and files created by MLM. In the case you are using mySQL, it will also remove the list table from the database. In other words, the Uninstall command restore MLM back to its initial state. Note that deleted lists are not recoverable.

New paragraph Import (Pro version only)

New paragraph This command allows the administrator to import one or several lists previously uploaded to your server with an FTP client. MLM expects the lists to be available in the 'imports' directory at script level. If that directory doesn't exist just create it. Upload your list(s) to it and run the command. Recipients will be imported to the list(s) listed in the 'list' parameter. Set action to 'update' in order to add recipients to a existing list(s) taking care of duplicates. You can allow duplicates by adding the optional '&dups=1' parameter. Set action to 'overwrite' if you want to replace all the recipients in current list(s) with those new entries. Once done the script will output import results. Your list(s) must be tab delimited list(s) with at least the 'First name', 'Last name', 'Company' and 'Email address' fields in that same order. NOTE: List(s) are not deleted from the 'imports' directory, you have to do that manually after you have finished with the import process. For security reasons don't let those files there!

New paragraph Get a parameter value

New paragraph This command allows the administrator to get a given parameter value. That command can be used in web pages or for diagnosing MLM.

New paragraph Get current MLM version

New paragraph This command allows the administrator to get the MLM version.

New paragraph Diagnose MLM

New paragraph This command allows the administrator to diagnose MLM.

Advanced commands:

New paragraph Getting statistics: [Admin]


New paragraph This command allows the administrator to get statistic data from a given delivery.


Recent questions from our users
  How can I send Base64 encoded messages with MaxBulk Mailer? NEW YouTube Video
  I set up my bulk email message but authentication fails NEW YouTube Video
  Is Maxprog software prepared for macOS 11 Big Sur? NEW Screenshot
  How do I use Mandrill for sending emails NEW Screenshot
  Emails not delivered despite successful delivery report NEW YouTube Video
  Do I need a mail server account to use MaxBulk Mailer? NEW YouTube Video
  How can I validate Hotmail and Gmail email addresses? NEW Screenshot
  I have bought a new computer, how do I transfer the license? NEW YouTube Video
  Ha desaparecido mi contabilidad de iCash NEW Screenshot
  How many emails can we send in a single click? NEW YouTube Video
  What does 'relay not permitted' mean? NEW YouTube Video
  Do I need my own SMTP server to use MaxBulk Mailer? NEW YouTube Video
  We want to include click-through in our emails. NEW YouTube Video
  What is the MaxBulk Mailer privacy policy? NEW Screenshot
  How does the base64 encoding function work? UPDATED YouTube Video
  Does eMail Verifier need port 25 or an SMTP relay to work? UPDATED Screenshot
  How to get started with eMail Bounce Handler UPDATED YouTube Video
  How can I clean up the blacklist? UPDATED YouTube Video
  No Images in Preview (only object frames) UPDATED Screenshot
  How can I send a test email message using my list UPDATED YouTube Video
  Sorting a recipient list by date using an optional column data UPDATED Screenshot
  I want to get click-though statistics with MLM UPDATED YouTube Video
  How can I add an unsubscribe link UPDATED YouTube Video
  The Bank accounts are missing from the list Screenshot
  Office365 server SMTP settings Screenshot
  Je n'ai pas re√ßu le N¬į sur ma messagerie Screenshot
  eMail Verifier stops at 30% of the email file to be analyzed Screenshot
  Can I make payments with bitcoin ? Screenshot
  How can I send a link to a PDF YouTube Video
  My email service just blocked me for using MaxBulk Mailer Screenshot
  Sending emails through an Exchange server Screenshot
  Training live Youtube events, Q&A webinars and videos YouTube Video
  Where are the MaxBulk Mailer DKIM settings ? Screenshot
  Error #22 when trying to verify a list of email addresses Screenshot
  MaxBulk Mailer newsletter mailing list subscription Screenshot
  I lost my activation key (serial number), can I recover it? Screenshot
  Is there a limit to how many emails you can send ? YouTube Video
  I created all my transactions with the wrong year Screenshot
  Sending a unique invitation number with MaxBulk Mailer YouTube Video
  Using the Cc and Bcc fields YouTube Video
  The MaxBulk Mailer statistics button does not work YouTube Video
  Bitcoin Purchase Screenshot
  How can I do a simulated bulk e-mail delivery YouTube Video
  iCash on MacOS 10.15 Screenshot
  Comcast - An authentication error occurred Screenshot
  All entries timeout Screenshot
  How to transfer iCash account data to a new computer Screenshot
  Keeping output original Excel and CSV file format Screenshot
  PayPal error, do you accept Bitcoins? Screenshot
  A column has disappeared in the Account Manager Screenshot
  Bitcoin Payment Screenshot
  How can I update an asset value Screenshot
  How to handle bounced emails from Outlook Screenshot
  iCash file size grew up over 120 Mb Screenshot
  Need help installing MLM on server Screenshot
  What are your payment methods Screenshot
  Images not displaying in Preview after update to 8.7 Screenshot
  Not able to verify anything Screenshot
  How to send an email with a picture in the body YouTube Video
  Images are missing in the message preview Screenshot
  Mail being sent to unsubscribed addresses YouTube Video
  How to DKIM sign an email with MaxBulk Mailer YouTube Video
  Bad Gmail addresses marked as valid Screenshot
  Amazon SES (correct) settings Screenshot
  Importing Bank statements into iCash
  Picture with text on the right YouTube Video
  Error with every email-adress (even my own, working one)
  Not receiving the Delivery Report YouTube Video
  I've tried to download the latest version for 3 days...
  Nothing is downloaded
  MLM Unsubscribe feature
  Spaces disappearing when using the Styled Text format
  Email editor and responsive emails YouTube Video
  Text disappearing when previewing and sending Screenshot
  How does eMail Verifier compares to online services? Screenshot
  How to get click-through statistics with MaxBulk Mailer YouTube Video
  About eMail Extractor privacy Screenshot
  BCC sending mail merge email
  Question about your software
  Accessing the MaxBulk Mailer blacklist YouTube Video
  Scanning a subfolder rather than the entire inbox
  Erreur #103: Le URL n'est pas valide
  Cambiar de macOS a Windows
  Maxbulk - switching computers
  Stalled - Infinite Loop
  Unable to import my contacts into MaxBulk Mailer YouTube Video
  Setting DKIM for the first time
  MLM Unsubscribe Link Screenshot
  The application is crashing
  Authentication errors... YouTube Video
  Cannot authenticate with Gmail YouTube Video
  Desactualizado 32 bits a 64 bits
  Importing a csv/txt file YouTube Video
  Using eMail Bounce Handler
  Importing recipients from a text file YouTube Video
  The program does not verify any address
  Importing accounting data from Quicken
  Error cargando iCash
  TLS1.2 support
  eMail Verifier is timing out
  Upgrading 8.5 to 8.6
  Creating submaps
  Unexpected Blacklisting YouTube Video
  Comcast residential bulk limits
  HostGator delivery limits
  Someone using your software is sending SPAM
  Mise √† jour vers 8.6.1
  Quelle est la diff√©rence entre iCash et iCash SE?
  Error in the installation 'api-ms-win-crt-heap-l1-1-0.dll is missing
  Where are the SMTP settings stored? Screenshot
  Bad e-mail addresses are sometimes marked as valid
  Lately all my emails are going into the recipients spam folder
  Resend Registration Licenses
  Mail-merge sender data using tags YouTube Video
  How to embed a photo into the email text
  Not working Error #22
  MX record not found
  Messages says delivered but I haven't received it
  Lost emails
  Custom Attachments
  TLS 1.2 Support
  Upgrade MaxBulk Mailer SE to Pro
  I purchased the product and did not receive the serial number
  Reconciled amount is wrong
  Can't send emails thru Gmail YouTube Video
  No puedo registrar mi n√ļmero de Licencia.
  Where are the delivery logs?
  Most of my messages are rejected
  Activation Key
  Earthlink changed settings and MailBulk Mailer does not work
  Missing a lot of messages and labels in Italian
  eMail Verifier speed and capacity
  Using the List function
  No consigo que env√≠e mails. SSL
  Sending to a maximum of 300 e-mails per hour
  Using eMail Bounce Handler with eMail Verifier
  My customers are not receiving my messages
  Last update broke everything...
  Recuperar Maxbulk Mailer SE
  Icash update
  Wont print Anything
  MaxBulk Mailer no longer sending links
  Empty folder after download
  Fallo cierre programa
  Someone is illegally using your software with my email address.
  Mensaje de error al cerrar la aplicaci√≥n
  MaxBulk Mailer SE
  eMail Verifier is only able to test Gmail addresses
  Plan de actualizaci√≥n
  New download wont open
  No se ejecuta el programa
  Custom Max Bulk / Adding new features
  Someone is spoofing my email address to send spam
  eMail Extractor not working properly on my computer
  Email Verifier vs online verifers
  How can I use my update plan on a new computer?
  Why do I get a Delivery Report message after each delivery?
  What mail server can I use with MaxBulk Mailer? YouTube Video
  Subject Command Tag YouTube Video
  PDF attachments not received
  Remote lists
  D√©placement/copie de contacts entre documents
  MLM upload gives 0 address(es) have been uploaded to 'List'
  Where to find the log files of Maxprog Bulk Mailer
  Exporting data does not include past sent information
  Unsubscribe with text file does not update remote list
  Problemas de verificaci√≥n
  Result file takes long to appear
  Max Bulk Mailer crashes every time after send 100-150 emails
  Can't find my activation key
  eMail Verifier is Hanging up
  Authentication failed / Relaying error YouTube Video
  64bit version of iCash
  How do I turn of Click Tracking ? in Plain Text?
  eMail Extractor y mensajes en Outlook
  Desaparici√≥n de datos
  I have misplaced my activation key for eMail Extractor
  The program found no email addresses
  Computer crashed, trying to rebuild mailing lists and preferences
  MLM URLs don't work
  Creating a remote list
  No files in File Manager
  How can I update from iCash 7.5.3 (App Store) to 7.6.x
  Your Kind Assistance Please!
  Word docs with weblinks
  La page web re√ßue est diff√©rente de celle envoy√©e avec mbm
  Erreur de n¬į de s√©rie
  The software asks for an account ID and password
  Forwarding emails sent by MaxBulk, cut and paste not working
  MLM cannot connect
  Lost serial
  Freezes after pref change
  Resend/Recall Function
  Slow loading iCash data files
  Where are the logs?
  Won't send any emails
  Deal of the day is not applied
  My computer rebooted and i lost my serial number
  Transferring recipient lists between two MaxBulk Mailer copies
  Computar cuotas de hipoteca como gasto en los informes
  Won't verify lists
  Links not working
  MacOS 10.13 High Sierra
  64-bit version of iCash availability
  Email account is not connecting through Maxbulk server
  Je n'arrive pas √† envoyer mon message √† toute ma liste en une fois
  Quels sont mes identifiants MLM? Screenshot
  DMARC Evaluation error
  Where are the preferences and the lists stored on Windows?
  Web Page format doesn't work for me
  Upgrade to the App Store app?
  List of attachments in the Preview panel
  How do I get a picture to be displayed on the top of the message? YouTube Video
  Recipients are no longer organized alphabetically
  I would like to know if MaxBulk Mailer can personalize emails? YouTube Video
  Chinese characters and trial version footer issues
  How can I upgrade the App Store version to last available on maxprog?
  Unified Email server
  Desactivar notificaciones del plan de actualizaci√≥n
  It takes forever to import my email list into the software
  The iCash Currency Manager doesn't update anymore
  I'm receiving lots of 'Undelivered Mail Returned to Sender' bounces
  Connection problem with Apple iCloud server Screenshot
  Free upgrade, or not free?
  I can't send a PDF attached to my message when it contains pictures
  How can I download files with sequential numbers in their name? YouTube Video
  Problem applying styles to a conditional statement result
  Any MaxBulk Mailer tutorial to get started?
  How to upgrade from Standard to Pro Screenshot
  License Key Recovery
  Cannot install the last update
  MaxBulk Mailer sent all the messages to me rather than the recipients
  Erreur d'authentification du serveur Gmail YouTube Video
  Does MaxBulk Mailer come with its own internal SMTP server? YouTube Video
  Pi√®ces jointes
  Stops processing in the middle of the list
  I lost the activation code / license number
  How I can I recover the serial number?
  How I can change the old activation key with the new one?
  Adding Hyperlinks to MaxBulk Mailer messages
  Emails not received despite MaxBulk Mailer delivery confirmation
  Any dedicated bulk mail server I can use with MaxBulk Mailer? YouTube Video
  All transactions are displayed with the same date
  Can I pay with Bitcoins? Screenshot
  Adding an Unsubscribe link to messages YouTube Video
  Your document is set to ISO-8859-1 but your HTML code use UTF-8 Screenshot
  Problems with importing tab delimited files.
  Updates for AppStore Version
  Editing the Transaction Types list on Windows
  Probl√®me de connexion
  Adding a URL to an image and placing pictures side by side YouTube Video
  How to configure office 365 of microsoft Screenshot

  [Valid RSS]  Subscribe to Maxprog's Knowledge Base

Generic questions
New paragraph
How do I install Maxprog software on my computer?
MS Windows
New paragraph
How can I change an application language?
MS Windows
New paragraph
How to register the software I've just purchased?
MS Windows
New paragraph
How can I recover the serials I have lost of products I purchased here?
MS Windows
New paragraph
How can I recover my serial from a registered application?
MS Windows
New paragraph
How can I find out the product name and version my serial unlocks?
MS Windows
New paragraph
Where can I read your software License Agreement?
MS Windows
New paragraph
How to fix software issues (doesn't start, runs slowly, crashes often, ...)
MS Windows
New paragraph
Double-clicking on my files no longer opens them with the software, why?
MS Windows
Stan Busk If you want to make the most of the software that you have acquired at Maxprog, do not miss the Stan's Blog. It is a library of Tutorials and Tips covering specific features and tipical problems you may have when using our tools. This page is updated regularly depending on the topics discussed in our public forums and issues reported thru our HelpDesk. If you are interested on what we are currently working on (or want to participate in beta testings) don't miss the Stan's Logbook.

For years, MAX Programming has provided companies around the globe with sophisticated and innovative solutions. Our commitment to quality is not only evident in our products, but also in our people. It is our mission in Professional Support Services to ensure that our products perform to the fullest of their ability in order to meet the business objectives of our customers. We provide the tools and information required for improved productivity. To accomplish this, we offer an array of services including: Technical Support, Education Services and Consulting Services.

Maxprog is part of an internet site network made of desktoolset.com, emaildesignstudio.com, familycash.com, icash.promo, maxbulkmailer.com, maxprog.com, maxprog.net, maxprog.org, maxprog.us, myrecipients.com, newslettercomposer.com, sharedcontents.com, stanbusk.com, usertools.com.

Home Products Downloads News Store Support