TABLE OF CONTENTS › Tutorial

First things first:

  • Is Postmaster successfully installed and set to “Active”?
  • Is the Postmaster Library successfully installed and set to “Active”?
  • Do you have the Zem_Contact_Reborn plugin installed and set to “Active”? Remember that Zem_Contact_Reborn requires a separate language plugin to work properly.
  • Is your browser set to accept Javascript?

All set? OK, then. First things first — Click on the Postmaster tab under the Extensions tab in your Textpattern Admin. You will see three sub-tabs: Subscribers, Lists and Import/Export.

NOTE: The first time you click the Postmaster tab, the plugin automatically creates the two database tables needed to store information (one for lists, and one for subscribers). It will also enter a “default” list and a “test” subscriber to each table.

Click on the Lists sub-tab for now. This opens a “list of lists” page, with the total number of lists displayed at the top, a link to “Add a List,” a search form and a table displaying a list of all lists you have entered.

You can re-order the list of lists using the “Name” or “Admin Email” column headers. There’s a checkbox next to each list and a separate “Check All” box (you can select some or all lists and click the “Delete” button to delete). Currently there is only one list, “default,” which Postmaster entered for you. You’ll have to make some adjustments to “default” before we can send any mail so click the list name (“default”).

That brings up the Editing List page, which displays all the fields of data for each list: List Name, List Description, Admin Email, Unsubscribe URL, List Form and Subject Line.

You may change or edit any of these fields at any time, and then click the “Update List Information” button at the bottom to save your changes.

NOTE: In order to use a custom form for your emails (see TXP Forms as Email Templates) you must enter the name of the TXP FORM into the List Form field on this page.

For now, leave everything alone except the Admin Email field, in which you should enter a real email address. After you’ve entered the email address, click the “Update List Information” button.

A list isn’t really a list without a subscriber — so click the Subscribers sub-tab now. This opens a “list of subscribers” page much like the “list of lists” page. There is only one subscriber listed, “test,” with a faulty email address entered. Click on the subscriber name to update your subscriber’s information.

That brings up an Editing Subscriber page, much like the “Editing List” page you already saw. This page has quite a few more fields: Subscriber Name, Subscriber Email, Subscriber Lists and Subscriber Custom 1 through Subscriber Custom 10.

NOTE: The Subscriber Lists field should contain the word “default” — that means subscriber “Test” is a member of list “default.”

You may change or edit any of these fields at any time, and then click UPDATE SUBSCRIBER INFORMATION at the bottom to save your changes. For now, leave everything alone except the EMAIL, in which you should enter a real email address. After you’ve entered the email address, click UPDATE SUBSCRIBER INFORMATION.

Now that you have an updated list and subscriber, it’s time to mail your first email!

Click on the WRITE tab in your Textpattern Admin. Write a bit of content — give it title “newsletter test” and in the body, write “Hey diddy diddy, there’s a kiddy in the middle.” Assign the new article to a section that won’t go public, and click PUBLISH.

Once the page refreshes, you’ll see a new module underneath the SAVE button, called “Email to subscribers?” There is a dropdown menu and a set of radio buttons. Use the dropdown menu to select a list (currently you only have one choice) and fill a radio button other than “No” if you’d like to send a mail (“Test” sends mail to the admin email address of the selected list; “Yes” sends mail to the entire selected list).

Once you’ve selected your list, and the correct radio button (you selected TEST for your first one, right?), click the SAVE button again. You will be taken to the Bulk Mail screen, which shows your mail status. Wait there until you receive the all clear (if you selected Test, this is immediate).

Go to the inbox of whatever email you entered — you should have received an email called “Notification: …” Congratulations!

NOTE: if you have any problems up to this point, you need to come to the support forum thread for help.

Back to the Table of Contents

Comment

Hi.

Well, after install both plugins, I go to tab extensions, and then if I click over “add a suscriber” happens nothing, and the same for “Add a list”. Whats the matter?

Thanks in advance.

marcos · Feb 14, 09:07 AM · #

There’s a bug. Try clicking on one of the sub-tabs (Subscribers or Lists) and trying again. This is fixed in the next version.

Ben · Feb 14, 06:01 PM · #

I get the same error as Peter:

Warning: Missing argument 1 for page_url(), called in /home/gzdesign/public_html/txptemplate/textpattern/lib/txplib_misc.php(574) : eval()‘d code on line 228 and defined in /home/gzdesign/public_html/txptemplate/textpattern/publish/taghandlers.php on line 2911

Warning: array_keys() [function.array-keys]: The first argument should be an array in /home/gzdesign/public_html/txptemplate/textpattern/lib/txplib_misc.php on line 651

Warning: array_diff() [function.array-diff]: Argument #1 is not an array in /home/gzdesign/public_html/txptemplate/textpattern/lib/txplib_misc.php on line 651

Warning: Invalid argument supplied for foreach() in /home/gzdesign/public_html/txptemplate/textpattern/lib/txplib_misc.php on line 651

Andreas · Aug 5, 01:00 AM · #

in the forum is the solution, changing the site from test to live makes the errors disappear.

hth

Peter · Aug 9, 02:27 AM · #

Textile Help

Official Documentation for Postmaster (A Textpattern Plugin)

Get Postmaster

RELATED

REGULARS

DISCLAIMER

Postmaster is a plugin for Textpattern, and is licensed under the GNU GPL. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public Licens for more details.