PAGE TYPES
Shop
To add shop page to your site:
- Go to the Editing Tools.
- Press Live (Php) button in Insert page section and select Shop page.
- Select preferred layout preset. Shop page has a few predefined layout presets.
- Set any other options you want and press OK.
Basics
The SHOP PAGE (E-Commerce) represents the shop in your website. Visitors can browse your products, add items in their shopping cart and go through the checkout process.
- The page generates a list of all or a subset of the products, defined in your MySQL Shop database.
- You add products online using Shop Admin panel.
- EZGenerator shop consists of few pages, each one representing different step in the shopping. Shop frontpage displays a list of all categories in your 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.
- Each product in the shop will be formatted based on the layout you define and modify in the Web Editor. Each page has fields available in Macros Fields panel, that you can use to design the layout.
- All strange expressions as %SHOP_COUNTER%, %SHOP_CATEGORYCOMBO%, %short description%, %Name% build the page layout and define what information from the Catalog database to be displayed. They are called macros. For example, %Name% defines that product name will be displayed here. You can move these macros, delete or add more from Macros Fields panel.
- 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.
- When you add shop page, all seven subpages have default layout and in most cases you don't have to change anything inside this layout. You have to simply add products in the database file, confugure payment method in Shop Settings panel and publish your site.
- Shop Settings panel is special settings panel on the Toolbar where you configure your shop. In general you have to set your email address in Send Notification To box, and you have to configure what payment processor you will use in Payment section.
- You have two payment 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. With option 2) you have to set your shop to use the BANKWIRE option.
EZGenerator Shop is designed for small and medium amount of products. To use more products in shop, you better split them into categories.
To configure your shop:
- You need MySQL database.
 |
On some hostings, your provider has already created database for you. If this is your case, you don't need to create database, just fill the database settings on step 2). For example: on www.one.com, there is already database created and you can't add new databases. If you don't have a database, then you have to create one. On most hostings you will have some utility to manage databases. You can use this utilty to create a database. If you are not sure how to create database, contact your provider or check documentation for your server.
|
- Go to , and fill the MySQL settings - Host, Database name, Username and Password. On most hostings, Host name is localhost.
- Go to Shop Settings toolbar and fill Send notification to email address. This address will be used for any communication from shop.
- Go to Shop Settings toolbar and press Payment button. You have to configure here what payment processor you will use (for details see below).
- Publish your web site.
- Open Shop Admin panel and add categories and products.
| |
Shop page requires PHP enabled server, MySQL database and payment processor account (PayPal account or WorldPay account). |
Shop Structure
Shop structure consists of seven pages. You can customize the layout and page settings for each of them.
Frontpage
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 frontpage and drag-and-drop Html description field within the shop body section.
Accessible Macros/Fields
Each page has Macros/Fields panel, accessed via Editable Tools. 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 the shop.
- Category - Displays the category name for each category defined in the catalog.
- 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>%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 - Will be replaced by cart item price.
- Cart currency - Will be replaced by cart currency.
- Category drop-down menu - Category drop-down menu can be used as alternative way for displaying shop categories.
- Shop search - Adds search area to page. Search are is used by user to search the shop.
- Administrator - This object generates link to shop administrator panel.
- Nopagefooter - Creates NOPAGEFOOTER macros, which disables footer on Shop main page.
Note: Along with the described fields and special objects, for each shop page you can insert database fields - these are the black fields in Macros Fields panel.
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 product defined in the catalog.
- 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 - Will be replaced by cart object.
- Cart item price - Will be replaced by cart item price.
- Search - Adds search area to page. Search area is used by user to search the shop.
- Cart currency - Will be replaced by cart currency.
- Category drop-down menu - Category combobox can be used as alternative way for displaying shop categories.
- Products drop-down menu - Products drop-down menu can be used as alternative way for displaying shop products.
- Items Counter - Will be replaced by category order number (include this field within body section area).
- Navigation - Adds page navigation when products exceed one screen.
- 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 subcategories, 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).
- Sub-category drop-down menu - Sub-category drop-down menu can be used as alternative way for displaying shop sub-categories.
Image: When you insert IMAGE field, you have two optional attributes to set on the bottom - SCALE and POP_UP. Check SCALE attribute and set Width and Height if you want to scale the image. Then in POP_UP drop-down menu set how you want to display the popup (the box will show when you move mouse over image). After you insert the image field, you can make it hyperlink and link it to the Detail page.
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 - Will be replaced by cart currency.
- Previous product - Creates previous product link.
- Next product - Creates next product link.
- 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).
- Google checkout - Adds google checkout button in page. 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. You have to fill your merchant ID and define Tax and Shipping options. For more info, check How to configure Google Checkout .
- Subtotal - Displays subtotal on cart page.
- Shipping - Display shipping amount on cart page.
- Cart currency - Will be replaced by 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 - Will be replaced by 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 user's 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 in Shop Settings panel (if bankwire is used).
Accessible Fields and Special Objects
- Fields - Allows
you to add custom fields to your request page - TEXT, EMAIL, LIST, MEMO, CHECKBOX, RADIO BUTTON, IMAGE FIELD, FILE FIELD, BUTTON FIELD, DATE PICKER, DATE FIELD, TIME FIELD and PWD (password). When you insert custom field you have to set Caption, Name and Value. Use the Required checkbox if you want to set the custom field as required. When ready, simply drag-and-drop the field into the form. You can then double-click on it to access its Properties.
- 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.
- Payment method - Add payment method listbox to checkout page.
- Cart currency - Will be replaced by cart currency.
- 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 be displayed after successfull checkout.
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.
- Bankwire section - Defines optional bank wire section. This section can be used to define bankwire 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).
- Cart currency - Will be replaced by cart currency.
- 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 few of them.
To configure your shop, go to Shop Settings tab on the toolbar and use Payment button to enter Shop Payment Control String dialog where you have to set control string for each payment processor you will use.
If you will only use PayPal to process shop payments, you can add PayPal button to Shop Cart page - this will send cart data directly to PayPal (checkout page will be skipped).
If you don't want to use any of the above listed payment processors, but need simply to recieve customer order at your email, use the BANKWIRE payment option.
Here is how it works: customer orders at your shop, shop collects customer data and sends it to 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 recieves e-mail with his order, where you can include your bank account number for example. After you recieve 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 . Make sure to configure these settings.
Notification
- Send Notification to(editbox) - Define shop Administrator e-mail address. This address will be used for any communication from shop.
- Shop Name (editbox) - Type here your shop name.
- Admin Notification (button) - Press this button to set subject and message for the notification email sent to administrator when order is made.
Settings
- Data (button) - Use this button to open Database Fields dialog, where you can add more fields.
- Shop Name (button) - Type here your shop name.
- Payment (button) - Press this button to open Shop Payment Control String dialog, where you set your payment processor - PayPal, WorldPay, Nochex, Authorize.net, Ideal or Eway.
In Shop Payment Control String window, use Add button to select payment provider that you intend to use in your shop. For PayPal only you can check Sandbox to use PayPal test processor. Use Load Default Settings button to load default settings for the selected payment provider.
Shop Payment Control String window has three grids with key&value settings.
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.
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).
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 that Paypal is implemented within EZGenerator shop according to the documentation at Website Payments Standard, option C.
Use Delete button to delete certain control string.
- Shipping (button) - Select one of the shipping options here. You can define additional shipping settings in shipping settings dialog.
- Settings (button) - Press this button to access settings submenu.
Decimals (spin
box) - Lets you set the number of decimals used to display prices in shop.
Currency (drop-down menu
box) - Lets you define shop currency.
Download link expires in (number selection box) - Sets expiration date for the downloadable items.
Absolute Paths in Shop (edit box) - Check this box if you want to use absolute paths inside shop.
Disable Night Phone Fix (edit box) - Check it to disable the night phone fix.
Single Framed table open at the same time(check
box) - If you use Framed tables with drop-down in your shop, check this box to allow only one open table at the same time.
Send Notification On Bankwire Order Only (editbox) - Check this box if you want order notification to be sent only when bankwire is used.
- Labels (button) - Sets the few messages used in shop. You can translate the default captions in your preferred language. Use Default settings button to restore the default settings.
Front Page
- Columns (spin
box) - Sets the number of columns the Shop should use
to list the categories on shop front page.
Categories Page
- Columns (spin
box) - Sets the number of columns the Shop should use
to list the records.
- Max items / 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 Records (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 Records 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.
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 Shop: %PAYMENT_TYPE%','%ORDERS_LINK%','%ORDER_ID%','%FORM_DATA%','%SHOP_CART%','%SHOP_IPUSER%','%ORDER_DATE%