Skip to main content

Getting Started

Settings​

  1. In Wordpress, go to Wordpress Admin > Settings > WithWine.
  2. Ensure the necessary fields are configured. These fields can be found by going to WithWine > Brand > Website Tab:
    • Environment
    • Brand ID
    • Client ID
    • Client Secret
  3. Double-check that the Website URL in WithWine > Brand > Website matches the URL of your Wordpress site. This is used for authentication so must match exactly (including the www part of the domain if in use). This can be modified in the Wordpress Admin > Settings > WithWine > WordPress Website Base URL field. The default value in this field will match your Wordpress site URL.

Once you've set up these fields, you should see login and cart buttons appearing on your Wordpress site. You should now be able to login successfully to your site.

Setting up your Store Page​

  1. Create a Wordpress page for your Store page. This can be done by going to Wordpress Admin > Pages > Add New. The page can be named anything you like.
  2. In the page content, add a shortcode to display the products you wish to display. For now, you can use the shortcode [withwine type="store"].
  3. Visiting the page you just setup, you should be able to see your products.
  4. If you wish, you can configure the ordering and sectioning of products by creating "eCommerce Section" Product Lists in WithWine > Brand > Products > Product Lists.
  5. You can also add these as custom filters by selecting "eCommerce Filter" as the Product List type as well.
Customising your store page

There are more details on how to configure the store page using shortcodes in the Readme.md file of the plugin. This also includes other shortcodes you can use to build product pages, including using featured-lists, store-filter and store-products.

Setting up your Product Page​

  1. Create a Wordpress page for your Products page. This can be done by going to Wordpress Admin > Pages > Add New. The page can be named anything you like.
  2. Add the shortcode [withwine type="product"] to the page content and save the page.
  3. Once saved, the page's numeric ID will be displayed in the URL of the page. Copy the ID.
  4. Paste the page ID into the Wordpress Admin > Settings > WithWine > Product Page Template ID field.
Customising your product page

There are more details on how to configure the product page using shortcodes in the Readme.md file of the plugin. This also includes other shortcodes you can use to build product pages, including using the [withwineapi type='product'] shortcode which allows you to render individual product fields directly yourself.

Setting up a Clubs Page​

You can use these shortcodes for your club pages depending on what you want to achieve:

  • [withwine type='clubs' /]
  • [withwine type='my-memberships' /][withwine type='conditional-content' data_showif='loggedout' data_action='login' data_text='Please log in to see your memberships' /]
  • [withwine type='club-wizard' data_club_id='<CLUB ID>' ]

You can also just create your own club page without using the WithWine plugin and simply link to /JoinClub/${clubId}?bid=${brandId} for each club.