Skip to content

Commit c813aa2

Browse files
authored
Merge pull request #910 from w3bdesign/develop
Remark formatting
2 parents 257ecd3 + 004d144 commit c813aa2

File tree

1 file changed

+61
-55
lines changed

1 file changed

+61
-55
lines changed

README.md

Lines changed: 61 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
# Next.js Ecommerce site with WooCommerce backend
99

10-
## Live URL: https://next-woocommerce.dfweb.no
10+
## Live URL: <https://next-woocommerce.dfweb.no>
1111

1212
## Table Of Contents (TOC)
1313

@@ -19,70 +19,76 @@
1919

2020
## Installation
2121

22-
1. Install and activate the following required plugins, in your WordPress plugin directory:
22+
1. Install and activate the following required plugins, in your WordPress plugin directory:
2323

24-
- [woocommerce](https://wordpress.org/plugins/woocommerce) Ecommerce for WordPress.
25-
- [wp-graphql](https://wordpress.org/plugins/wp-graphql) Exposes GraphQL for WordPress.
26-
- [wp-graphql-woocommerce](https://github.com/wp-graphql/wp-graphql-woocommerce) Adds WooCommerce functionality to a WPGraphQL schema.
27-
- [algolia-woo-indexer](https://github.com/w3bdesign/algolia-woo-indexer) Sends WooCommerce products to Algolia. Required for search to work.
24+
- [woocommerce](https://wordpress.org/plugins/woocommerce) Ecommerce for WordPress.
25+
- [wp-graphql](https://wordpress.org/plugins/wp-graphql) Exposes GraphQL for WordPress.
26+
- [wp-graphql-woocommerce](https://github.com/wp-graphql/wp-graphql-woocommerce) Adds WooCommerce functionality to a WPGraphQL schema.
27+
- [algolia-woo-indexer](https://github.com/w3bdesign/algolia-woo-indexer) Sends WooCommerce products to Algolia. Required for search to work.
2828

2929
Optional plugin:
3030

31-
- [headless-wordpress](https://github.com/w3bdesign/headless-wp) Disables the frontend so only the backend is accessible. (optional)
31+
- [headless-wordpress](https://github.com/w3bdesign/headless-wp) Disables the frontend so only the backend is accessible. (optional)
3232

3333
The current release has been tested and is confirmed working with the following versions:
3434

35-
- WordPress version 6.0.1
36-
- WooCommerce version 6.4.1
37-
- WP GraphQL version 1.5.0
38-
- WooGraphQL version 0.6.2
35+
- WordPress version 6.0.1
36+
- WooCommerce version 6.4.1
37+
- WP GraphQL version 1.5.0
38+
- WooGraphQL version 0.6.2
3939

40-
2. For debugging and testing, install either:
40+
2. For debugging and testing, install either:
4141

42-
https://addons.mozilla.org/en-US/firefox/addon/apollo-developer-tools/ (Firefox)
42+
<https://addons.mozilla.org/en-US/firefox/addon/apollo-developer-tools/> (Firefox)
4343

44-
https://chrome.google.com/webstore/detail/apollo-client-developer-t/jdkknkkbebbapilgoeccciglkfbmbnfm (Chrome)
45-
44+
<https://chrome.google.com/webstore/detail/apollo-client-developer-t/jdkknkkbebbapilgoeccciglkfbmbnfm> (Chrome)
4645

47-
3. Make sure WooCommerce has some products already or import some sample products
4846

49-
The WooCommerce sample products CSV file is available at `wp-content/plugins/woocommerce/sample-data/sample_products.csv` or [Sample products](sample_products/)
47+
3. Make sure WooCommerce has some products already or import some sample products
5048

51-
Import the products at `WP Dashboard > Tools > Import > WooCommerce products(CSV)`
49+
The WooCommerce sample products CSV file is available at `wp-content/plugins/woocommerce/sample-data/sample_products.csv` or [Sample products](sample_products/)
5250

53-
4. Clone or fork the repo and modify `.env.example` and rename it to `.env`
51+
Import the products at `WP Dashboard > Tools > Import > WooCommerce products(CSV)`
52+
53+
4. Clone or fork the repo and modify `.env.example` and rename it to `.env`
54+
55+
Then set the environment variables accordingly in Vercel or your preferred hosting solution.
56+
57+
See <https://vercel.com/docs/environment-variables>
58+
59+
5. Modify the values according to your setup
60+
61+
6. Start the server with `npm run dev`
62+
63+
7. Enable COD (Cash On Demand) payment method in WooCommerce
64+
65+
8. Add a product to the cart
66+
67+
9. Proceed to checkout (Gå til kasse)
5468

55-
Then set the environment variables accordingly in Vercel or your preferred hosting solution.
56-
57-
See https://vercel.com/docs/environment-variables
58-
59-
5. Modify the values according to your setup
60-
6. Start the server with `npm run dev`
61-
7. Enable COD (Cash On Demand) payment method in WooCommerce
62-
8. Add a product to the cart
63-
9. Proceed to checkout (Gå til kasse)
6469
10. Fill in your details and place the order
6570

6671
## Features
6772

68-
- Next.js version 12.3.1
69-
- Connect to Woocommerce GraphQL API and list name, price and display image for products
70-
- Support for simple products and variable products
71-
- Cart handling and checkout with WooCommerce (Cash On Delivery only for now)
72-
- Algolia search (requires [algolia-woo-indexer](https://github.com/w3bdesign/algolia-woo-indexer))
73-
- Meets WCAG accessibility standards where possible
74-
- Placeholder for products without images
75-
- Apollo Client with GraphQL
76-
- React Hook Form with form validation and error display
77-
- Animations with Framer motion, Styled components and Animate.css
78-
- Loading spinner created with Styled Components
79-
- Shows page load progress with Nprogress during navigation
80-
- Fully responsive design
81-
- Category and product listings
82-
- Pretty URLs with builtin Nextjs functionality
83-
- Tailwind 3 for styling
84-
- JSDoc comments
85-
- WooCommerce cart session is automatically deleted after 48 hours to prevent GraphQL session expiration errors
73+
- Next.js version 12.3.1
74+
- React 18
75+
- Connect to Woocommerce GraphQL API and list name, price and display image for products
76+
- Support for simple products and variable products
77+
- Cart handling and checkout with WooCommerce (Cash On Delivery only for now)
78+
- Algolia search (requires [algolia-woo-indexer](https://github.com/w3bdesign/algolia-woo-indexer))
79+
- Meets WCAG accessibility standards where possible
80+
- Placeholder for products without images
81+
- Apollo Client with GraphQL
82+
- React Hook Form with form validation and error display
83+
- Animations with Framer motion, Styled components and Animate.css
84+
- Loading spinner created with Styled Components
85+
- Shows page load progress with Nprogress during navigation
86+
- Fully responsive design
87+
- Category and product listings
88+
- Pretty URLs with builtin Nextjs functionality
89+
- Tailwind 3 for styling
90+
- JSDoc comments
91+
- WooCommerce cart session is automatically deleted after 48 hours to prevent GraphQL session expiration errors
8692

8793
## Troubleshooting
8894

@@ -101,15 +107,15 @@ More testing and debugging is required before deploying it in a production envir
101107

102108
With that said, keep the following in mind:
103109

104-
- Currently only simple products and variable products work without any issues. Other product types are not known to work.
105-
- Only Cash On Delivery (COD) is currently supported. More payment methods may be added later.
110+
- Currently only simple products and variable products work without any issues. Other product types are not known to work.
111+
- Only Cash On Delivery (COD) is currently supported. More payment methods may be added later.
106112

107113
## TODO
108114

109-
- Add total to cart/checkout page
110-
- Show stock quantity on individual products
111-
- Copy billing address to shipping address
112-
- Display product variation name in cart / checkout
113-
- Hide products not in stock
114-
- Add better SEO
115-
- Re-add Next/image when it is working better
115+
- Add total to cart/checkout page
116+
- Show stock quantity on individual products
117+
- Copy billing address to shipping address
118+
- Display product variation name in cart / checkout
119+
- Hide products not in stock
120+
- Add better SEO
121+
- Re-add Next/image when it is working better

0 commit comments

Comments
 (0)