MSMO Sites

Sections

• Creating Products
• Creating Departments
• Shortcodes
• eShop testing
• Going Live with eShop
• Configuration
• Product Images
• Option Sets
• eShop Admin Pages
• Why is an Order Still Pending?
• eShop Base
• Cart Operations
• Conflicting plugins
• Compatability
• Notes on activation
• Deactivating and Uninstalling

Creating Products

Adding a product is as easy as creating a page. Just fill in the required fields within the Product Entry section when creating or editing a page.

The Sku should be a unique identification reference for your product eg.abc001.

The Product Description is a short description of the product. This is used in the customers cart, and will appear on their invoice from Paypal.

Option x, Price x and Download x are the individual item and price, thus allowing several options for each product eg. Small, Medium, Large. If there is only 1 option for a product, then please use the Option 1 and Price 1 input fields.

The Download selection boxes only appear if you have uploaded a file via eShop for download. To link to a file, select it from the dropdown list. Downloadable options now default to free shipping in the cart – even if you set the shipping rate as something different. This allows for online and offline options for the same product (e.g. book and ebook).

Choose your Shipping Rate carefully, F is set aside for any Free shipping (obviously downloadable products should use this).

The Featured Product product selection chooses whether that product can be listed as a featured product.

A product is unavailable for sale until Stock Available is set.

Stock Quantity – sets the quantity available for this product. A quantity needs to be entered for download products. I suggest you enter a 1.

Creating Departments

There are many options, but a suggested layout would be:

• Online Shop Page Parent: Main Page
  • Department A Page Parent: Online Shop
    • Product 1 Page Parent: Department A
    • Product 2 Page Parent: Department A
  • Department B Page Parent: Online Shop
    • Product 2 Page Parent: Department B
    • Product 3 Page Parent: Department B

Shortcodes

To then list the products on the Online Shop and Department pages there are various options available. You will need to add to those pages one of the following codes:

Shotrtcodes	Attributes: Defaults shown(where applicable)
	class	panels	form	show	records	sortby	order	list	id	imgsize	excludes
[eshop_list_subpages]	eshopsubpages	no	no	100	10	post_title	ASC		no	100
[eshop_list_featured]	eshopfeatured	no	no			post_title	ASC			100
[eshop_list_new]	eshopsubpages	no	no	100	10					100
[eshop_random_products]	eshoprandomlist	no	no	6	6			yes		100	0
[eshop_show_product]	eshopshowproduct	no	no						0	100
[eshop_best_sellers]	eshopbestsellers	no	no	100	10					100
[eshop_list_alpha]	eshopalpha	no	no		25					100

[eshop_list_subpages]

This displays a list of pages with products and is ideal for use on a Department page.

[eshop_list_featured]

This displays products that have been as set as a Featured product. Suggested use for this is on the main Online Shop page.

[eshop_list_new]

This displays latest products. Suggested use for this is on a separate Latest Products page.

[eshop_random_products]

This displays a random selection of products. This could be used on the Online Shop page, or on other pages within your site.

[eshop_show_product]

Can be used to display a specific product, or products.

[eshop_best_sellers]

Can be used to display the best selling products.

[eshop_list_alpha]

Experimental Displays products alphabetically split by alphabet and 0-9. A selection list of A to Z plus 0-9 is included.

Remember you do not have to add in the defaults. You should only add the attributes when you want to change from the defaults.

Examples

• [eshop_list_subpages class="myclass"] changes the default class to ‘myclass’
• [eshop_show_product id='9' class='hilite' panels='yes' form='yes'] shows product ’9′ only. Changes the default class to ‘hilite’, shows the product as a panel and the add to cart form is shown.

Details for attributes:

• class example: class=”myclass” to change the default class.
• panels example: panels=”yes” to show ‘panels’
• form example: form=”yes” to add the shortened add to cart form.
• show example: show=”10″ limits the display to 10 products.
• records example: records=”5″ limits the number of products shown ‘per page’ to 5.
• sortby example: sortby=”post_title” shows the pages in alphabetical order. Possivle values: post_date, post_title or menu_order
• order example: order=”ASC” shows the results in ascending, or descending order. Possible values: ASC or DESC
• list example: list=”no” limits the display to 1 random product.
• id example: id=”25″ or id=”25,29,52″ shows specific products only. For subpages, only one id can be used.
• imgsize example: imgsize=”50″ would resize the image to 50% of its original width and height.
• excludes example: excludes=”5,14″ allows you to exclude items from the list.

sortby and order replace the following settings from earlier versions:

• Featured and department product sort order
• Random products to display
• Department Products to display

Extra

1. [eshop_show_discounts] This displays a table of discounts and a paragraph for the free shipping discount. This will only show if set.
2. [eshop_show_shipping] (automatically added to the Shipping Rates page) can now be amended via the attribute
   shipclass. example shipclass=’A,B,F’ would only display shipping classes A, B and F (dependant on the shipping rate calculation used).
3. [eshop_show_payments] Displays a list of images with the current payment methods allowed.
4. [eshop_empty_cart]Message[/eshop_empty_cart] Specifically designed for the cart page, any Message you enter will only be displayed if the cart is empty.
5. [eshop_cart_items] A simple shortcode for use in templates via the do_shortcode function. In its simplest form it displays the number of items in the cart. It can be adjusted with the following attributes before and after, which can be used to insert text before and after the cart size.
   hide is also available, setting this to yes will stop the shortcode from displaying anything if the cart is empty.

6. [eshop_addtocart] will enable the add to cart form to appear anywhere on a product page. By default the form appears after the content. (not fully tested – please let me know if it causes problems).
7. [eshop_welcome] print a simple name of the customer. You can use the following attributes: before – which could be used to add mark up, returning – perhaps use a phrase like welcome back, guest – the phrase you would like to use for a guest, after – again could be used to close the markup.
   This has also been written for use in templates, add something like:

   <?php
echo do_shortcode("[eshop_welcome before='<span style="color:red;">' returning='Welcome back' guest='Hello Guest' after='</span>']");
?>

Notes

By default eShop will not display a form, even if specified via a shortcode, on WordPress post listing pages – category, search etc. To enable this you need to change the setting in the Product Listings section of the settings page.

eShop Testing

To test eShop with Paypal you need to have an account on Paypal Sandbox. You will need to create and utilise email addresses for the ‘seller’ and ‘buyer’ within the sandbox when you test the cart. To make test purchases whilst in test mode you have to be logged into WordPress and Paypal Sandbox.

Testing with Payson just requires a standard Payson account.

Going Live with eShop

On the Settings – eShop – Merchant Gateway page you then need to change the following.

• Business Location — Your 2 letter country code.
• Currency Code — your 3 letter currency code.

If using Paypal then those setting must match those at Paypal.

You then need to enter various settings depending on the payment option you choose to use.

On the main Settings – eShop you will need to change these settings:

• Currency Symbol — The symbol for your currency e.g. £.
• eShop Status needs to be set to Live.

It would also be advisable to visit the eShop – Shipping page.

Everything should then be set up and working!

Configuration

There are a number of settings that should be configured before you can start selling.

Go to Settings – eShop. This page features the main options for the plugin. Defaults have been added for your convenience, where possible.

General

eShop Admin

eShop status – is the cart live or in test mode?

Orders per page – this value sets how many items (orders, products etc.) per page are displayed on the various admin pages.

Business Details

eShop from email address – eShop will use this as the ‘From’ address in the automated emails.

Available business email addresses – extra business email addresses for use when contacting customers via their order details.

Product options

Options per product – how many different options values can you add to a product.

Out of Stock message – when you run out of stock you may want to temporarily display an out of stock message.

Stock Control – If checked, when a products stock level falls to 0 or below, the product will automatically be marked as ‘not available’ However stock levels are not checked during the order process, and stock reduction is only processed after a successful purchase. Therefore it is possible to sell more items than you have in stock.

Show stock available – if using stock control this allows you to display the stock avaialble.

Currency

Symbol – whether it be $, £, etc.

Product Listings

Show add to cart forms on WordPress post listings – Warning activating this can invalidate your site!. By default eShop will not add forms, even if specified by a shortcode, to WordPress post listing pages. By enabling this option the add to cart form will be added, where possible to all posts, in category listings, search results, etc.

The following Product Listings options have now been deprecated, and replaced by shortcodes (see above).

• Featured and department product sort order
• Random products to display
• Department Products to display

Cart Options

Percentage size of thumbnail image shown in cart – leave blank to not show the image – takes the standard thumbnail produced by wordpress and reduces it by the value entered to fit into the shopping cart.

Sub Pages

This option, sometimes referred to as ‘fold menus’, can automatically hide sub pages until their parent page is viewed. (hides links to shop pages until you go into the shop). Warning this affect all sub page listings on your site.

Search Results

Add image to search results – if used eShop will add an image to the search results page for any post or page or product pages only.

Credits

Display eShop credit allows you to hide the ‘Powered by eShop‘ credit that appears on various pages in your shop. Disabling this will still add a hidden HTML comment to the page.

Cron

Cron automatically sends out a daily email to the specified address if there are any outstanding, or pending, orders.
This is only triggered when someone visits the site.

To stop this feature, simply delete the Cron Email address.

Merchant Gateway

General Settings

Both of these settings must match those at paypal, if used, but should be set for all merchant gateways.

Business Location – which country you are in.

Code – a 3 letter currency code that matches your country.

Paypal

Email address: the email address associated with your Paypal business account. Ensure that you enter it correctly!

Send buyers email address to paypal?:(experimental) unsetting this may change the login screen at Paypal to highlight ability to pay without joining Paypal.

Payson

Warning – all Payson transactions are in SEK irrespective of settings within eShop. there is also a minimum order value, which is not reflected in the shopping cart on the site. However it will be shown to the buyer when they go to pay.

The Email address, Agent ID and Secret Key must match those at Payson.

You need to set a Cart Description and this will be used in place of the shopping cart at Payson.

Payson has a minimum order value which, at time of writing, is 4 SEK. The Min. Cart value alters the amount that Payson recieves to ensure the minimum value is met. Payson refuses values less than this.

eProcessingNetwork

Warning – test mode does not look any different on the payment side.

Cash

Orders placed here are automatically added to the awaiting payment page.

webtopay

For help with webtopay please contact Markas Krasovskis

Authorize.net

Settings must match those set at Authorize.net exactly.

Discounts

Spend – how much needs to be spent before % Discount is applied.

Spend over to get free shipping – how much needs to be spent before the order qualifies for free shipping.

In both cases deleting the amount will cancel the discount.

Downloads

Downloadables

Download attempts – the number of download attempts that you will allow per purchase, per file. If set to 0 you will stop all downloads! The default value is 3.

Downloads Only

If using eShop for a downloads-only store, then setting this to ‘yes’ will hide the shipping rates link, and provide a shorter checkout form.

Special pages

Continue Shopping Link

If you enter the page id of your main Shop page, then eShop will use that for the Continue Shopping link. Leave this blank and eShop will either link to the last product, or to the main page of your site automatically.

Link to extra pages

Here you can add 2 extra links to appear in various places in the cart/checkout procedure that link to a Privacy Policy, or Help page. The page id number should be used.

The Shipping Rates page id should be available by default.

Automatically created pages

These are automatically generated when eShop is first activated. Changing these could affect how eShop works, but are available for amendment should you delete a page in error. All of these pages require shortcodes to work correctly.

Other Settings

The eShop Shipping Rates menu item also allows you to amend the shipping calculations and set whether you would like to use the zones set up by country, or by country specific State/County/Province. The Show Shipping Zones on Shipping Page option allows you to automatically show the correct table for the zones. Be warned that these tables are large.

The Appearance eShop page allows you to amend the default style, or disable it completely. Note: If your theme has an eshop.css then that will be used.

Settings – eShop Base

This section sets up defaults that may be useful if you want to use Google Base. Anything entered here is applied to all products. You don’t have to enter anything but the more information you supply the better. You are able to override these settings per product via the eShop – Base page.

Brand – if you sell one particular brand, set it here.

Condition – choose from one of the options available.

Product expiry in days – Google base automatically expires products listed after 30 days, but yo can set a different value here.

Product type – if you sell one type of product eg. figurines, set it here.

Payment Accepted – comma delimited list of payment methods available in addition to Paypal.

Reset eShop Base

This resets all data that has been set using the eShop – Base page.

Appearance – eShop

Some default style has been included with the eShop plugin to allow you to get up and running as quickly as possible. On this page you are able to disable the default styling if you would rather use style associated with a particular theme. If the CSS file is editable you can also edit it directly via this page.

Should your theme already have an eshop.css file then it will be used by default.

Product Images

You can add and use any image to a product page. But for eShop to find and use that image in shortcodes and widgets that image must be associated with that page or post. This is easily achieved by ensuring you upload the image via the media toolbar when editing that page or post. That image is then associated with that page and eShop can find and use it.

Option Sets

Create any number of option sets, which can then be added to any number of products. There is no restriction on how many can be added to a product, or how many item you can have in an option set.

Each option set can be a dropdown select box, or a series of checkboxes. Each option within a set can have additional price, which is added onto the default price for that item.

Deleting an option set removes it from all products.

eShop Admin Pages

Orders

• eShop & Stats – a quick statistics page showing how many orders are in the system.
• Pending – not yet processed – orders are automatically removed from here after 4 days (Paypal can take that long to interact with your system)
• Active – these orders have been paid for and a successful transaction has been completed.
• Shipped – you may want to move an order here after you ship it.
• Failed – hopefully never used but, if there is a problem with a payment for an order, it will show here.
• Deleted – when you delete an order, it is initially moved to here. You then have the facility to delete *all* orders over a certain age – x hours. Once deleted from this section, the order is completely removed from the database.

Each page lists orders (except statistics). Select an individual order to view the full order details. The customer’s email address is highlighted and can be used to contact the customer. Selecting the Customer’s email address will take you to a Customer Contact page containing a pre-filled ‘customer response’ email template for your use.

Shipping

Shipping Rates

Shipping rate calculations – 3 methods are offered:

• Method 1 ( per quantity of 1, prices reduced for additional items ) may take a while to calculate, but is possibly of greatest use.
• Method 2 ( once per shipping class no matter what quantity is ordered )
• Method 3 ( one overall charge no matter what quantity is ordered )

Each of these methods still allow for a ‘per zone’ price.

Shipping Zones – choose between US States or Countries to be used.

The Show Shipping Zones on Shipping Page option allows you to automatically show the correct table for the zones. Be warned that these tables are large.

The table for the shipping charges is fairly complex, but hopefully easy to follow.

Shipping Rate F is preset for ‘FREE’ delivery and cannot be amended.

Countries and State/County/Province

Default zones are pre-configured for both ‘Countries’ and ‘State/County/Province’ but can be amended if necessary.

Paypal doesn’t list all countries, so you may need to check the list to ensure it is correct. Obviously you should delete any that you feel you don’t want to deliver to. At the bottom of each form there is a blank field to allow you to add to these lists.

Products

This page lists all the products you have entered, along with a few statistics.

Downloads

Providing the downloads directory is writable, you can upload files here. These will become available for sale within your eShop.The page lists all available downloadable products (that you have previously uploaded), along with a few statistics.

As a security measure you are not able to delete a file that is currently available for sale within your eShop.

Uploading large files

Any files that you FTP to the correct eshop_downloads directory can be added by visiting the Unknown Download Files section on the eshop Downloads page.

An alternative method is to amend your main wordpress .htaccess file, or amend your sites php.ini. The following are an example set of directives to be added to the htaccess file.

# BEGIN eShop
php_value upload_max_filesize 100M
php_value post_max_size 200M
php_value memory_limit 400M
php_value max_execution_time 10800
php_value max_input_time 10800
php_value session.gc_maxlifetime 10800
# END eShop

This is not done automatically as which method you can use may be reliant on your hosting company.

Discount Codes

Various options have been created to give a wide variety of discount codes, from single use to unlimited. This can be a set discount, or for free shipping.

Base

Manage your products for Google Base.

The details for each product can be tweaked by following the Sku link.

For images to be used they must be uploaded via the page the product is allied to.

Emails

This allows you to edit the email templates:

• The Automatic order email is sent out automatically when a successful transaction is recorded on your system.
• The Customer response email can be sent at any time from you order details screen.

The other templates are empty by default, make sure you add some content to them before activating them!

About

List initial installation and configuration help, along with eShop credits.

Help

This page!

Why is an Order Still Pending?

Pending orders should be automatically moved to Active once a successful transaction has taken place. However there are a few circumstances where this might not happen. This mainly relates to orders from Paypal.

• A customer cancelled the transaction.
• Part of the Paypal transaction was invalid.
• Paypal’s server is down, possibly for maintenance.

In all cases before you decide to move an order from pending, check the following.

Paypal service status

Paypal Live Site Status : it is always worth keeping an eye on this page for outages and planned maintenance.

Has 4 days passed?

Paypal can take up to 4 days to interact with your web site with regard to any transaction. Orders are automatically sent to Deleted orders after 4 days via eShop. However no orders are fully deleted unless you specifically request it, so the order can be retrieved at a later date.

Did you recieve a transaction notification?

All successful, and most unsuccessful, orders generate a system email to your Paypal address. This email should be kept as a permanent record of the transaction. These are useful for checking outstanding transactions.

Check your Paypal account

Check your account at Paypal to see if there are any sales that don’t tie up with anything.

eShop Base

eShop Base creates a data file for upload to Google Base.

Manage – eShop base Feed

Download or view online your product feed for uploading to Google Base.

Cart Operations

After items are added to the Cart, the customer can complete a form on the Checkout page before being redirected to the merchant gateway for payment. A successful payment will auto generate an email to the customer and yourself. The email sent to you will have a subject containing the phrase {merchant gateway} IPN. This is a quick record of the transaction that should be kept as a permanent record. The email to the customer details their order and includes a download link, along with their login details when necessary. This download information is comprised of their email address, and a unique code. They have ‘x’ attempts to download a file, as set in the eShop settings.

If using Paypal, and providing Paypal has successfully accepted payment, a download form will be available should the customer come back to the site.

If the order just contains downloads it should be automatically moved to the Sent orders page, otherwise they will be sent to the Active page for delivery.

Notes on activation

The default pages for eShop are:

• Shipping Rates: [eshop_show_shipping]
• Shopping Cart : [eshop_show_cart]
• Checkout : [eshop_show_checkout]
• Thank you for your order: [eshop_show_success]
• Cancelled order : [eshop_show_cancel]
• Downloads : [eshop_show_downloads]