Shopware 6: Installation Guide

This comprehensive guide should be followed to seamlessly install, configure, and troubleshoot the Quivers Plugin for Shopware 6. It provides step-by-step instructions, starting from prerequisites and installation to detailed configuration settings for both Quivers and Stripe. Additionally, it includes troubleshooting tips to address common issues, ensuring a smooth setup process for your ecommerce platform.

Table of Contents

Prerequisites

Before you begin, ensure you have the following:

  • Quivers Integration Extension Package
    • Please reach out to support@quivers.com if you have not received the zip file.
  • Details provided by Quivers:
    • Quivers API key
    • Business RefId
  • Disable all tax configurations (Quivers extension will manage taxes)

Steps to update tax configurations:

  1. Navigate to Catalogs → Products.
  2. Select the product you want to edit.
  3. Scroll down to the Prices section.
  4. Set the Tax rate to Highly Reduced.
  5. Click Save.

Installation

Steps to install the Quivers Plugin:

  1. Login to your Shopware account as an administrator.
  2. Navigate to Extensions → My Extensions.
  3. Click on Upload Extension and upload the Quivers Integration Extension Package shared with you.
  4. Install and Activate the Plugin.

Configuration

Configure Quivers Settings

  1. Go to the Sales Channel tab in the sidebar.
  2. Select your Sales Channel.
  3. Go to the General tab.
  4. Navigate to Quivers Settings.
  5. Enter the following details:
    1. Business RefId: Provided by your Quivers project manager.
    2. Shopware Base URL: Enter the base URL of your Shopware site.
    3. API Key: Provided by Quivers.
    4. Shopware Admin Username and Password: Used for API authentications.
    5. Preorder Key: Your predefined key.
  6. Set the following:
    1. Quivers Sandbox Enabled: Set to 'Yes' for test environment.
    2. Quivers Debug Mode: Set to 'No'.
  7. Click Save.

Configure Stripe

  1. Go to the Sales Channel tab in the sidebar.
  2. Select your Sales Channel.
  3. Go to the General tab.
  4. Navigate to Quivers Settings.
  5. Scroll down to the Payment and Shipping section.
  6. Select Quivers Stripe from the dropdown.
    1. Optionally, set it as the default payment method in the Default Payment Options dropdown.
  7. Click Save.

Troubleshooting

Common Issues and Solutions:

  • Quivers Plugin Configuration Issues
    • Ensure all data points are valid and correct.
    • Verify that all fields have values.
  • Stripe Payment UI Issues
    • Ensure Quivers settings are saved and all values are valid.

By following these steps, you should be able to install and configure the Quivers Plugin on Shopware 6 without any issues. For further assistance, refer to the official Quivers support resources or contact support@quivers.com.