Paloma Postman Widget


The Postman Widget is a plugin developed by Paloma that allows administrators of WordPress websites to
collect newsletter subscriptions from their visitors. To do this, the WordPress user must first have an
account on the Paloma website and an address list where the new subscriptions should be added.

The widget currently only accepts a subscription if it has a name and a valid e-mail. The admin can
also select up to three optional fields for the subscription in the widget menu.


  • The Postman widget on a WordPress website
  • Widget menu with basic settings


After you have downloaded and installed the plugin files, you must supply the plugin with a valid
customer ID and Hash. To receive this information, contact and ask for the ID
and Hash for this WordPress plugin.

When you have your ID and Hash, go to the Settings menu in WordPress and select Postman Widget.
Type the ID and Hash into the appropriate fields and press the Save Changes button, then examine the
message below the line. If it says that “You have address lists”, the ID and Hash are correct and you
may use the plugin. However, if it says that “The ID and Hash are incorrect”, then you should contact again and ask for help with the issue.

Once you have saved the correct ID and Hash in the settings, the widget is ready to use on your WordPress
site. Go to the Appearance menu, select Widgets, and then drag the Postman Widget from “Available Widgets”
to the place you want the widget to be on your site.


Why isn’t the plugin being shown in the settings or in the widget menu?

Make sure that the plugin has been properly installed and activated. Go to the Plugins menu, select
Installed Plugins, and check that Postman Widget is shown in your list of plugins. If it is not active,
press the Activate link to activate the plugin.

Why can’t I select an address list in the widget menu?

If the widget menu does not display any address lists, it means the plugin could not reach the Paloma API
and request address lists with your ID and Hash. Make sure that the ID and Hash are correct, and that
there is no issue with your network connection. If the problem persists, contact

How do I change the appearance of the widget on my site?

You can use Cascading Style Sheets to control the appearance of Postman Widget. A CSS file is included
with the plugin, and contains a basic style. By changing the CSS, you can customize the look of the
widget for your site.

I get an error that says “SoapClient” not found.

This means that the host has not installed the SoapClient extension on their server, which is required to
run the Postman Widget. In order for the plugin to work, you will need to contact your host and ask them to
install SoapClient.

What should I do if there is an error with the plugin?

Contact and explain the issue.

Contributors & Developers

“Paloma Postman Widget” is open source software. The following people have contributed to this plugin.




  • Updated a deprecated constructor method to prevent a warning in PHP.


  • Updated form action and method. This should fix a 404 error on some websites that use the HTTPS protocol.


  • Fixed an error when retrieving only one address list from Postman.


  • Fixed problem with displaying latest mailings.


  • Fixed some warnings and notices when running the widget in development mode.


  • Added the remaining optional subscriber fields (Phone, Fax, Address, Postal Code, City, Country).


  • Improved the style of the widget and made it easier to customize with CSS.
  • When showing recent mailings, the widget no longer displays the time of day of the mailing.
  • Added three optional subscriber fields (Title, Company, Cell Phone).


  • First public release.