...
| Store home page | |
| List of products (Home page) | |
| Product Information (View page) | |
| Categories list (Categories page) | |
| Contact info | |
| About us | |
| Order Checkout (Cart page) | |
Shopping Cart Features
List of cart items The shopping cart page, lists the cart items previously added.
It is possible to edit the quantity of items and also to remove items from the cart.
|  Image Modified
|
Checkout Form
If there are items in the cart, the checkout form is displayed.
Mandatory fields are marked with a orange asterisk.
The customer notification is sent to the email specified in this form.
It is not mandatory to be a registered user, in order to do the checkout. |  Image Modified
|
Shopping Cart Administration Features
Shopping Orders Administration Only administrators can access this feature. Site administrators can go to the Site / Content / Shopping Orders to access to the administration features. |  Image Modified
|
Site Shopping Cart Configuration The configuration is editable by site. Configuration is in the three dots menu at top right. The details of the configuration are described in the section Shopping Cart Configuration. |  Image Modified
|
Shopping Orders The option Shopping Orders will display a list of the orders for each available site, this will allow a portal to host more than one store and manage each one independently. The list will display all existing orders with basic information about the status and the customer. |  Image Modified
|
Updating Order Status The admin can update orders status using the following process: In Progress: The customer is adding products to the order, no actions available Waiting for Payment or Waiting for Paypal: If the user chooses to pay using paypal the status will be updated automatically when the IPN is received (see Paypal docs for more info), the order can be updated as Paid or Canceled if the customer never pays. Paid: The payment has been confirmed and the order can be processed, the order can be updated as Processing Delivery Processing Delivery: The items for the order are being prepared for shipping Shipped: All items for the order have been shipped for the customer Canceled: There was something wrong with payment and the order will not be processed
|  Image Modified
|
Orders Details The admin can also look at the details for each order including customer contact information, shipping information, product information and update custom notes to have a better control over the process. |  Image Modified
|
Installation
Obtain E Commerce Theme from the Liferay Marketplace.
Deploy E Commerce Theme in your existing Liferay 7 installation. If you haven’t installed Liferay 7, please download and follow the instructions to do so.
Creating a New Site
- Go to Control Panel / Sites / Sites.
- Click in Add Button and select E Commerce Theme.
|  Image Modified
|
- Create a new store site. Enter the name of your preference for it. In this example we are creating "My Store".
|  Image Modified
|
- Go to Site / Navigation / Public Pages and click in the three dots menu. Select Configure.
- Upload a logo for the site. In the example we are using Liferay logo.
|  Image Modified Image Modified
|
- If you want to avoid change to the site template affects your site:
- Go to Site / Configuration / Site Settings.
- Disable propagation of changes.
|  Image Modified
 Image Modified
|
- Go to Navigation Menu Portlet and click in the three dots menu. Click on Configuration.
- Select the template called Shopping_Nav-1.0.0 and save the configuration.
|  Image Modified
 Image Modified |
- You can navigate the site, It will display dummy content deployed with the theme.
|  Image Modified
|
| Anchor |
|---|
| ShoppingCartConf |
|---|
| ShoppingCartConf |
|---|
|
Shopping Cart Configuration
Only a site administrator can access this feature. As a site administrator, before to publish the Shopping cart to live, you must be sure to have the correct and complete configuration.
The configuration is editable by site. Go to Site / Content / Shopping Orders and click in the three dots menu at top right. Select Configuration. | Image Modified |
| In the fist tab Email From, you will set the name of your store and the email to be used as sender of all the emails from the site. |  Image Modified
|
In the second tab Email To Store, you can: - Enable or disable the notification to the store, when a customer places an order.
- Set Email Subject: Subject to be used in the notification.
- Set Email Body: Email body to be sent.
Please read the section Email Notifications to understand the requirements and the way the notifications work. |  Image Modified
|
In the third tab Email To Customer, you can: - Enable or disable the notification to the customer, once the checkout process is complete.
- Set Email Subject: Subject to be used in the notification.
- Set Email Body: Email body to be sent.
Please read the section Email Notifications to understand the requirements and the way the notifications work. |  Image Modified
|
| In the fourth tab Messages, you customize the main messages displayed in the shopping cart. |  Image Modified
|
In the fifth tab, Paypal, you can: - Enable or disable use of Paypal. Enable it to allow users to pay using Paypal.
- For test purposes (preventing to process real Paypal payments), you can enable the use of Paypal Sandbox. You can find the related information in https://developer.paypal.com/developer/accounts/.
- Set a valid Paypal Business Email.
| Note |
|---|
| title | Paypal SSL Configuration |
|---|
| In order to receive Paypal IPN payment notifications and additional parameter needs to be added to the app server JVM arguments: | Code Block |
|---|
| -Dhttps.protocols=TLSv1.1,TLSv1.2 |
|
|  Image Modified
|
| Anchor |
|---|
| EmailNotifications |
|---|
| EmailNotifications |
|---|
|
Email Notifications
| Note |
|---|
| title | Portal Properties Configuration |
|---|
|
In order to be able to recognize whether an email was properly sent or not, the shopping cart needs to have in the file portal-ext.properties:
| Code Block |
|---|
| mail.throws.exception.on.failure=true |
This setting allows the Shopping Cart to do a "rollback" of the checkout process.If this is not set, the Shopping Cart will not know when a checkout notification is not sent.
|
| In the Site Shopping Cart Configuration, you can edit the notifications that system will send to the store and to the customer. Review the terms you can use in the configuration form (under each email body), or in the following reference table. |  Image Modified
Variable | Use |
|---|
$date | The date on which the order was placed. | $customerName | The name of the customer (specified in the checkout form). | $customerEmail | The email of the customer (specified in the checkout form). | $customerContactInfo | A predefined template, for displaying the customer information (captured in the checkout form). This information does not include the customer email. | $orderSummary | Predefined for displaying the order summary. This summary includes the list of the items in the cart. | $orderTotal | A predefined template for displaying the order total. | $storeLogo | A predefined template for displaying the logo. This logo is the same as the logo used in the portal. | $storeName | The name of the store (specified in the "Email From" tab). | $storeEmail | The email of the store (specified in the "Email From" tab). | $portalUrl | The url of the portal. | $portalLogo | Portal logo image url. |
|
| This is an example of an OOB email sent to the store, when a customer places an order. |  Image Modified
|
| This is an example of an OOB email sent to the customer, when the checkout process is complete. |  Image Modified
|
Adding a New Product
- Go to the Site / Content / Web Content.
- Click in the add button and select Product-1.0.0.
|  Image Modified
|
- Fill the form with your product details.
|  Image Modified
|
- To show the products in the home and category pages you need select the checkbox "searchable".
|  Image Modified
|
- Remember to assign/create some tags to the product, they will be used for products categorization.
|  Image Modified
|
- You can also edit the dummy products or expired them by clicking in the three dots menu.
|  Image Modified
|
Code Repository
https://github.com/rivetlogic/liferay-ecommerce-theme
...
