Scot's Mailing list /
Miva Merchant Modules /
Miva Merchant 4
Miva Merchant 4
The Scotmail system must reside on the same domain as the store for the module to work.
The miva merchant 4 module is: scotmail_merchant4.mvc
This is a Miva Merchant fulfillment module that will put a pre-filled subscription box on the invoice page. At the click of a button, your customers can subscribe to one or more of your mailing lists at the same time.
Install the fulfillment module by following standard Miva Merchant module installation instructions. If you are not familiar with how
to install modules, please read the Miva Merchant help files.
Instructions for OpenUI Supermod/Other Page Templates/Open Designer Users
Note: ScotsScripts.com does not offer any support for OpenUI installations. Go to the miva forums for answers.
OpenUI is a necessary evil for people who want total customization control over their Merchant 4 stores. At some point in time, OpenUI users should start thinking about switching to Merchant 5.
The instructions below show a way to put a pre-filled email address text input and checkbox in your store so that it will show up during the checkout process. The instructions below may or may not work. Most people have had success.
These instructions were not written by anyone affiliated with ScotsScripts.com and are provided purely for the convenience of people who must use OpenUI and would like to try this.
Use the < input... > code below to display a subscription checkbox for your customers:
<input type="checkbox" name="smr_scotmail_subscribe" value="on"> subscribe to our mailing list
You can "pre-fill" the checkbox in by adding "checked" to it like this:
<input type="checkbox" name="smr_scotmail_subscribe" value="on" checked> subscribe to our mailing list
To comply with anti-spam regulations and help reduce the risk of your company being blacklisted for alleged spamming, your customers should actively choose to subscribe (by checking the check-box) and then confirm their request by clicking on a validation link via a follow-up email. Use the following code along with the checkbox to allow for this:
Be sure to have your validation pages set up for the mailing list you are using.
It is not required to use email validation. Without using it, customers who check the subscription check-box will automatically be added to your list and no confirmation email will be sent.
Add the following OpenUI token code on the page/template that immediately follows the page with the subscription check-box. The code below is what the system uses to add their email address to your mailing list.
Note: remember to use the %OUI% or %OUI1% as the first characters of whatever field you choose to use.
You MUST replace "Mailing List Id Here" with the ten digit mailing list ID number found in the mailing list properties page in the Scotmail administration (display mailing lists, then select the list you are using.)
If your mailing list ten digit ID is 1234567890, then the %DOFUNC line would look like:
Information for those using upsell:
If you put the check box on the OINF screen, then the openui token code should be placed on the upsell screen and not the OSEL screen.
If you are combining checkout screens, then this code should be placed on the very next screen the customer will see.
If for instance you are combining shipping/billing selection and payment information on the OSEL screen, then place the OpenUI token code on both the OPAY and the INVC screen. If your customer's payment information is accepted, they will next be on the INVC screen. However, if any payment information is missing, they would go to the OPAY screen before the INVC screen.
Many thanks to Jason Henderson and JMH Web Services for suggestions and help in making the OpenUI features of this module to work. Visit
http://www.jmhonline.net/searchmiva for their free newsletter on search engine optimization and marketing for the Miva Merchant 4 store owner.
updated April 23, 2013
