PAGE TYPES

Shop

The SHOP PAGE (E-Commerce) is the shop page on your website. Visitors can browse your products (you add these via live interaction with your shop through the Administrator Panel) add items to their shopping cart and go through the checkout/payment process.

You can preview shop page only when uploaded on a PHP enabled server. To test this functionality offline you can Install your own test server on your PC.

Basics

Some comments about how the shop is configured and works:

• Products - The page lists items/products defined in your Shop database. You create a shop structure in EZGenerator and THEN add products/items online using Shop Admin panel accessed via Central Admin panel.
• Database fields - Fields are defined in Shop Settings > Data. You can add additional fields here.
• EZGenerator shop - May consists of multiple pages, each one representing different step in the shopping. For example, shop main page displays a list of all categories in your product database. When you click on a specific category, you will be redirected to the categories page where all items from selected category will be displayed. If you click on a specific product, you can check detailed information in its detail page. You can then add some products in your shopping cart and go through the checkout process.
• Shop items - Each item/product in the shop will be formatted based on the layout defined in the Web Editor (EDIT MODE in EZGenerator). Each page has fields available in Fields panel, are used to design the layout.
• Macros (Strange looking code) - Expressions such as %SHOP_COUNTER%, %SHOP_CATEGORYCOMBO%, %short description%, %P_name% build the page layout and define what information from the Catalog database to be displayed. They are called macros. For example, %P_name% defines that product name will be displayed here. You can move these macros, delete or add more from Fields panel.
• Internal comments - All expression enclosed with < and > define sections. They are not displayed, they are for internal use only, so you should not delete them. < SHOP_BODY > is the main section in Shop Main, Categories and Cart pages. All fields inserted within the body section are replicated for each shop category/product.
• Adding a shop - When you add shop page there are seven subpages created with a default layout. In most cases you don't need to change anything inside the layout. Simply add products from the database file, configure the payment method in Shop Settings panel and publish your site.
• Settings panel - Shop Settings panel is special settings panel where you configure your shop. In general you have to set your email address in Admin section >> Admin Email box, and you have to configure what payment processor you will use in Checkout/Shipping section, Setup Control String (if you want to use any payment processor from the below listed).
• Payment options - You have two options 1) To use any of the following payment providers - PayPal, WorldPay, Nochex, Authorize.net, Ideal or Eway. OR 2) To receive the order submitted as email. If this is the case you will have to set your shop to use the BANKWIRE option.

NOTE: The EZGenerator Shop is designed to work well for small to medium numbers of products, if you have a lot of products make sure to create Categories so customers are not faced with 100's of products stretching down the page. For example, if you sell music you may categorize it by CD.

Shop page requires PHP enabled server, MySQL database and payment processor account (PayPal account or WorldPay account).

Database

This page always use MySQL database.

Shop Structure

Shop structure consists of seven pages. You can customize the layout and page settings for each of them.

Main page

This page is portal for your shop and is used to display brief info about shop, shop categories list and shop search function. Body section is the main element in this page. All fields inserted within the body section are replicated for each shop category. Selecting one of the categories from this page will take users to categories page.

You define categories in Shop Admin panel.

To show category description field on shop main page, go to shop main page and drag-and-drop Html description field within the shop body section.

Accessible Fields and Special Objects

Each page has Fields panel, accessed via Toolbar. This panel contains objects that you can insert on page.

• Body section - Defines the body section within the page. Body section is the section that is replicated and parsed for each category defined in catalog lister's category field.
• Category - Displays the category name for each category defined in catalog lister's category field.
• Category link - Displays the category name for each category defined, set as link.
• Category count - Displays the number of products within a category (include this field within body section area).
• Random product - Displays random product. After you insert this field, specify which product fields to be displayed for the random product (for example, <RANDOM>%P_Name%</RANDOM>). You can include multiple random products on a page.
• Items Counter - Will be replaced by category order number (include this field within body section area).
• Cart Item Price - Displays cart item price.
• Cart Currency - Displays cart currency.
• Category drop-down menu - Category menu can be used as alternative way for displaying shop categories.
• Category horizontal list - Builds category horizontal list.
• Category vertical list - Builds category vertical list.
• Search - Adds search box.
• Category search - Adds search box with option to search inside the category.
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop main page.
• Tell a Friend - This object generates link to Tell a Friend page.

Note: Along with the described fields and special objects, for each shop page you can insert form controls for any field in your database.

Categories page

This page is used to display all products for a selected category. The body section on this page is replicated for every product from the selected category. You can limit the maximum number of products per page or add (not required) cart to this page.

Accessible Fields and Special Objects

• Body section - Defines the body section in this page. Body section is replicated and parsed for each category defined in catalog lister's category field.
• Category section - Defines category header section that will display custom category information if you have defined such information (see above).
• Buy button - Adds buy button. Buy button will be created for every product listed on page (include this field within body section area).
• Quantity (form) - Adds quantity edit box that will allow buyers to change quantity of the products they buy (include this field within body section area).
• Cart Item Price - Displays cart item price.
• Cart - Adds cart into categories page.
• Search - Adds search box to page.
• Category search - Adds search box with option to search inside the category.
• Category drop-down menu - Category menu can be used as alternative way for displaying shop categories.
• Cart Currency - Displays cart currency.
• Category horizontal list - Builds category horizontal list.
• Category vertical list - Builds category vertical list.
• Products drop-down menu - Products menu can be used as alternative way for displaying products.
• Items Counter - Will be replaced by category order number (include this field within body section area).
• Navigation - Builds page navigation bar.
• Categories link - Creates link to shop main page.
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop categories page.
• Sub-categories - Creates links to the sub categories, if any are defined for current category. You have to first set sub-category field in Shop Main Settings panel, Sub-Category property (see above).
• Subcat drop-down menu - Sub-category menu can be used as alternative way for displaying shop sub-categories.

Note: When you insert IMAGE field, you have few optional attributes to set - Main Image Scale and On Click Display.

Detail page

This page represents detailed information for a selected product. Each product in the categories page links to its corresponding detail page by default.

Accessible Fields and Special Objects

• Buy button - Add buy button.
• Quantity (form) - Adds quantity edit box that will allow buyers to change quantity of the products they buy (include this field within body section area).
• Cart Currency - Displays cart currency.
• Previous product - Builds link to previous product.
• Next product - Builds link to next product.
• Navigation - Builds page navigation bar.
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop detail page.

Cart page

This page represents the shopping cart in your shop.

If you only use PayPal account to process shop payments, add PayPal button to page - this will send cart data directly to PayPal. Otherwise add checkout button - this will send cart data to checkout page.

Accessible Fields and Special Objects

• Body section - Defines the body section in this page. Body section is replicated and parsed for each product in cart.
• Delete button - Adds delete button. Delete button will be created for every product listed in cart page (include this field within body section area)
• Checkout button - Adds checkout button. Checkout button will bring user to checkout page
• PayPal button - Adds PayPal button. PayPal button sends cart data directly to PayPal account without passing through shop checkout page (checkout will be processed by PayPal). NOTE: Customers do not need a PayPal account to use PayPal, only a credit card. They can use this at the PayPal site to make a payment.
• Google checkout button - Adds Google checkout button. This button will redirect buyers to Google Checkout page. After you insert this button, double-click to open its Properties, where you have to set your Google checkout settings.
• Subtotal - Displays subtotal on cart page.
• Shipping - Display shipping amount on cart page.
• Cart Currency - Displays cart currency.
• Order Total - Displays order total on cart page.
• Quantity (form) - Adds quantity edit box that will allow buyers to change quantity of the products they buy (include this field within body section area).
• Basket cleanup - Creates button that users can use to clean up the basket content.
• Items count - Will be replaced by the number of all items in your cart (include this field within body section area).
• Items count2 - Will be replaced by the number of unique items in your cart (include this field within body section area).
• Quantity - Displays the quantity of each item that is added in your cart (include this field within body section area).
• Cart Item Price - Displays cart item price.
• Line total - Displays line total on cart page (include this field within body section area).
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop cart page.

Checkout page

Checkout page is a form where the customers data is collected. Depending on the selected payment type, this data will be sent either to your payment processor (PayPal, WorldPay, Nochex, etc ) or to administrator's e-mail address defined inn Shop Settings panel (if bank wire is used).

Accessible Fields and Special Objects

• Submit Button - This creates an image button "send", which sends the checkout content to payment processor. The following initialization properties are available: Caption (text box) - Lets you set the button caption.
• Reset Button - Insert an image button "reset", which clears all contents in the web form. The following initialization properties are available: Caption (text box) - Lets you set the button caption.
• Hidden Field - Allows you to add hidden fields to your form. Hidden fields are not visible or accessible to the site visitors, but can be used to pass certain data, for example, the page from where the form was sent, or to help you to categorize the information when you receive it. The following initialization properties are available: Name (text box) - Lets you set the field name; Value (text box) - Sets the field value.
• Custom Field - Allows you to add custom fields to your checkout page. Custom fields are fields not connected to contacts/catalog database. Use custom field to create more advanced forms. The following field types are available: Text, Memo, Listbox, Checkbox, Radio, File, Button, Date and Password. When you insert custom field you have to set Caption, Name, Type and Value. Use the Required checkbox if you want to set the custom field as required.
• Payment method - Add payment method listbox to checkout page.
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop checkout page.
• Confirm email feature: You can insert second email address field in your checkout form to be used as confirm email field. This way you may require buyers to confirm their email address before submitting the form. To accomplish this drag-and-drop second email address field from Fields panel, and change its name - for example, if your normal email field has name "EmailAddress", the confirm email address field should have name "EmailAddress_confirm".

Return page

This page will is displayed after successful checkout & payment.

Accessible Fields and Special Objects

• Body section - Defines the body section in this page. Body section is replicated and parsed for each product in cart.
• Bank wire section - Defines optional bank wire section. This section can be used to define bank wire related return page.
• Item name, sub name, category, amount, count - Defines items related values returned from checkout page (include this fields within body section area).
• Subtotal, Shipping, Order Total, Order Id. - Defines order related values returned from checkout page.
• Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop return page.
• Back to Shop button - Creates link to Shop main page.
• Items count - Will be replaced by the number of all items in your cart (include this field within body section area).
• Items count2 - Will be replaced by the number of unique items in your cart (include this field within body section area).

More return sections: Similar to "Bank wire section", you can set different return sections for each payment method defined in "checkout" page - <PayPal> and </PayPal>, <WORLDPAY> and </WORLDPAY>, etc. Use <DEFAULT> and </DEFAULT> for the payment method set in "checkout" Special Settings as default.

Checkout error

This page will display an error message in case the checkout form hasn't been filled in correctly.

Shop Payment

EZGenerator shop supports PayPal, WorldPay, Nochex, Ideal, Authorize.net and Eway payment processors. You can use one or several of them.

• To configure your shop - go to Shop Settings, Checkout/Shipping tab and use Setup button to enter Control String dialog where you have to set control string for each payment processor you will use.
• PayPal only - add PayPal button to Shop Cart page - this will send cart data directly to PayPal (checkout page will be skipped).

• Email payment method - If you don't want to use any of the above listed payment processors, but need simply to receive customer order at your email, use the BANKWIRE payment option. Here is how the email method works: The customer orders at your shop, the shop collects the customer's data and sends it to the shop administrator, together with cart content and order ID. At the same time customer is redirected to shop return page where you provide him with information what to do next. He also receives e-mail with his order, where you can include your bank account number for example. After you receive payment from customer, you send him the products ordered. You can also use shop admin section to send customer confirmation e-mail after you receive his payment.

Shop Settings

The following properties are available in the Shop Settings panel, accessed from the Toolbar. Make sure to configure these settings. This panel is divided into few sections. At the bottom right of some, there is small button (). Press it to access more settings.

Notification

• Send Notification to(text box) - Set the shop Administrator e-mail address. This address will be used for any communication from shop. You can set multiple email addresses, using (;) as delimiter.
• From (editbox) - Specify the "From" email address. Use different email address than in "Send to" to avoid email being marked as spam.
• Admin Notification (button) - Press this button to set subject and message for the notification email sent to admin. The default %FORM_DATA% macro will be replaced with the list of all form field values. If you want to include only some of them, remove %FORM_DATA% and use form field macros (Example: %Name%, %Email%, %Place%, etc).
• Callback Notification (button) - Press this button to set the subject and message for the notification email sent to admin when a payment has been made.

Shop Settings

• Data (button) - Use this button to open Database Fields dialog, where you can add more fields.
• Payment (button) - Use this button to open the Shop Payment Control String dialog, where you configure the payment processor settings (where you use any of PayPal, WorldPay, Nochex, Authorize.net, Ideal or Eway). For PayPal only you can check the Sandbox to test your shop using PayPal without making actual payments. Use Load Default Settings button to load default settings for the selected payment provider.

The Shop Payment Control String window has three grids with key&value settings.

The first grid contains the required settings that are sent to the selected payment provider. In general, you have to only set your payment provider account - business for PayPal, instid for WorldPay, email for Nochex, ewayCustomerID for Eway. For Ideal you set your payment provider account in merchantID property, but you also have to fill the hash property as follows: [hashkey][merchantID][subID] - [hashkey] needs to be replaced with hashkey defined in your ideal account; [merchantId] with your ideal payment account and [subID] with 0. You can get your hashkey from ING Ideal Dashboard. For authorize.net you have to set x_login and x_tran_key.

The second grid contains additional info that could be sent along with the required info, if Send detailed product info is checked (available for PayPal, WorldPay and Ideal).

The third grid contains data that will be sent as callback from the selected payment processor after order is completed, if use Callback is checked (available for PayPal and WorldPay).

Note: PayPal is implemented within EZGenerator shop according to the documentation at Website Payments Standard, option C.

Use the Delete button to delete a control string.

Checkout Page Target (drop-down menu) - Sets target for checkout form. Use 'New Window' when in Frames mode and 'PayPal' is enabled.

Below are few special settings needed if you use IPN (Instant Payment Notification).

Send E-mail to customer on CallBack (IPN) (editbox) - Use if you want to receive an email from the payment processor when the order is completed.

• Shipping (button) - Use to see the shipping options here. You can define additional shipping settings in shipping settings dialog.
• Settings (button) - Use to see some extra settings.

Decimals (number box) - Set the number of decimals used to display prices in shop.

Currency (drop-down menu box) - Define shop currency.

Download link expires in (number selection box) - Set an expiration date for the downloadable items.

Absolute Paths in Shop (edit box) - Check this box to use absolute paths inside shop (specific and fixed links to items).

Single Framed table open at the same time(check box) - Use Framed tables with drop-down in your shop, check this box to allow only one open table at the same time.

Notification On Bankwire Only (editbox) - Enable order notification to be sent only when bankwire is used.

Shop Name (editbox) - Your shop name.

Database Sharing - Set more than one shop page to use same database. For more info on the topic, check: How to use Database Sharing

Front Page

• Columns (selector) - Sets the number of columns the Shop should use to list the categories on shop front page.
• Direction (drop-down menu) - Sets the direction of the categories list - horizontal or vertical.
• Labels (button and editable listbox) - Sets the captions used in shop. You can translate the default captions in your preferred language or use one of the presets. Use Default settings button to restore the default settings.

Categories Page

• Columns (number box) - Sets the number of columns the Shop should use to list the records.
• Products / page (drop-down menu box) - Limits max record count on page. If catalog selection contains more records, extra pages are generated. To link this extra pages add 'Previous' and 'Next' page fields to lister
• Order Products (drop-down menu box) - Use this drop-down menu to select a field to be used as sort criteria. Check Descending to sort items in descending order.
• Order Products II (drop-down menu box) - You can select here field as second sort criteria for the items in the Shop. Check Descending to sort items in descending order.

RSS

• Feed Settings (button and editable listbox) - Sets some special RSS settings.
• Limit Products (number selection box) - Sets the maximum number of products to be included in the RSS feed.
• Scale Image (max width) (check box and number selection box) - Check it if you want include scaled image in RSS item description.

Shop Admin panel

In Shop admin panel you manage products and orders in your shop - define categories, add products, manage orders, and configure few options in the Setup.

All orders

Here you can find list of all orders made in your shop. When you move mouse over order date you will access options to check order details, and also to confirm the order (if still not confirmed). Confirmed orders are those for which payment has been completed. For bankwire orders you can confirm and send email to the buyer.

Confirmed orders

These are orders for which payment has been completed. When bankwire payment method is used, you have to manually confirm the order in All Orders section when the buyer makes the payment. With PayPal, the order gets confirmed when payment at paypal is done and paypal sends callback to the shop to notify it.

Categories

Products in shop are organized in categories. In this screen you can add/edit/remove categories.

Products

In this screen you manage your products.

Stock

In this screen you manage your stock - you can define how many products to keep in stock and also monitor how many products have been sold.

Setup

In this screen you define few settings:

Each time someone submits an order at your shop, order notification is sent to administrator, according to the settings in this section. Optionally you can also enable confirmation email to be sent to customer.

• Last Order ID (edit box) - By default order ID starts with 1, 2, 3, ... to count from a higher value, change the last order ID. For example, you can set 5745 here and next order will have ID 5746. Makes you look successful!
• Bankwire Confirmation Subject (edit box) - Subject for the email sent to buyer after his order is confirmed by administrator.
• Bankwire Confirmation E-mail (button) - Message for the email sent to buyer after his order is confirmed by administrator.
• Bankwire Notification Subject (edit box) - Subject for the email sent to buyer after he submits his bankwire order.
• Bankwire Notification E-mail (button) - Message for the email sent to buyer after he submits his bankwire order.
• Order Confirmation Subject (edit box) - Subject for the email sent to buyer after his paypal order gets confirmed.
• Order Confirmation E-mail (button) - SMessage for the email sent to buyer after his paypal order gets confirmed.

Mini Cart

If you want to insert mini cart in your shop, use <MINI_CART>...</MINI_CART> syntax to define one on shop main, categories or detail page. You can also use one of the predefined shop page layouts, supporting shop mini cart.

Shop Search

EZGenerator shop supports two search types: exact search and one field search.

Exact search makes search for records that match all the words from the search criteria. In this case search covers all catalog database fields.

One field search makes search in one single field in the catalog database. To set one field search, insert hidden field (from Fields panel) with name=type and value= fieldname, where fieldname is the name of the field you want to search in.

Macros in shop

Here is a list of macros used in the Shop: %PAYMENT_TYPE%','%ORDERS_LINK%','%ORDER_ID%','%FORM_DATA%','%SHOP_CART%','%SHOP_IPUSER%','%ORDER_DATE%