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.
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 firstname.lastname@example.org 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 email@example.com 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.
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.
The plugin is visible in the list of widgets but not in the settings.
This issue can be caused by some security-related plugins or by server configuration. Check to see if the user has permission to edit PHP files.
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 firstname.lastname@example.org.
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 email@example.com and explain the issue.
以下人員參與了開源軟體〈Paloma Postman Widget〉的開發相關工作。參與者
- Added error handling if the call to Paloma API should fail.
- Added support for Contacts.
- Changed capability requirement for editing plugin options from edit_plugins to manage_options.
- Cleaned up code, added a plugin icon and updated FAQ with a known issue.
- Fixed a PHP warning from a deprecated constructor.
- Added option to activate consent gathering for GDPR (General Data Protection Regulation).
- 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.