Documentation

ShopBite Plugin Installation

This chapter guides you through the installation of the ShopBite Plugin in your Shopware 6 system.

Prerequisites

  • Shopware 6.7.0 or higher (installed and functional)
  • PHP 8.4 or higher
  • Composer 2.0 or higher
  • Database access with sufficient permissions

Installation Methods

1. Installation via Composer (recommended)

# Install plugin via Composer
composer require shopbite-de/shopware-plugin

# Activate plugin
bin/console plugin:install --activate ShopBite

# Clear cache
bin/console cache:clear

2. Installation via Shopware Plugin Store

  1. Open Shopware Administration
  2. Navigate to Extensions > Store
  3. Search for "ShopBite"
  4. Click Install
  5. Click Activate

3. Manual Installation

# Download plugin
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip
unzip shopbite-plugin.zip -d custom/plugins/ShopBite

# Install and activate plugin
bin/console plugin:refresh
bin/console plugin:install --activate ShopBite

# Run database migrations
bin/console database:migrate --all ShopBite

# Clear cache
bin/console cache:clear

Installation Process in Detail

Step 1: Download Plugin

# Composer method (recommended)
composer require shopbite-de/shopware-plugin

# Manual method
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip
unzip shopbite-plugin.zip -d custom/plugins/ShopBite

Step 2: Register Plugin

# Update plugin list
bin/console plugin:refresh

# Install plugin
bin/console plugin:install ShopBite

Step 3: Activate Plugin

# Activate plugin
bin/console plugin:activate ShopBite

# Check status
bin/console plugin:list | grep ShopBite

Step 4: Run Database Migrations

# Run migrations
bin/console database:migrate --all ShopBite

# Check migrations
bin/console database:migrate:status

Step 5: Cache and Assets

# Clear cache
bin/console cache:clear

# Update theme cache
bin/console theme:compile

# Update administration cache
bin/console administration:build

Step 6: Check Permissions

# Set directory permissions
sudo chown -R www-data:www-data custom/plugins/ShopBite
sudo chmod -R 755 custom/plugins/ShopBite

# Cache permissions
sudo chmod -R 777 var/cache

Post-Installation

Administration Interface

  1. Open Shopware Administration
  2. Navigate to Extensions > My Extensions
  3. Find ShopBite Plugin and click Configure
  4. Perform basic configuration

Set Up API Access

# Create API integration
bin/console integration:create:admin --name="ShopBite Storefront" --description="API access for ShopBite Storefront"

# Set permissions
bin/console acl:role:create --name="ShopBite API Role" --description="API role for ShopBite"
bin/console acl:role:assign --name="ShopBite API Role" --resource="order:read,order:write,product:read"

Configure Sales Channel

  1. Navigate to Settings > Sales Channels
  2. Create New Sales Channel
  3. Configure ShopBite-specific settings
  4. Assign API access

Installation Verification

Check Plugin Status

# Show plugin status
bin/console plugin:list | grep ShopBite

# Show plugin details
bin/console plugin:info ShopBite

Check Database

# Check tables
mysql -u shopware -p shopware -e "SHOW TABLES LIKE 'shopbite_%';"

# Check data
mysql -u shopware -p shopware -e "SELECT * FROM shopbite_business_hour LIMIT 5;"

Test API Endpoints

# API test (replace URL and token)
curl -X GET "https://Your-Shopware-Domain.de/store-api/shopbite/business-hour" \
  -H "Authorization: Bearer YourAPIToken" \
  -H "sw-access-key: YourAccessKey"

Common Installation Issues

Problem: Plugin Not Visible in Administration

Symptoms:

  • Plugin is installed but not visible
  • Error: "Plugin not found"

Solutions:

# Clear cache
bin/console cache:clear

# Update plugin list
bin/console plugin:refresh

# Check permissions
sudo chown -R www-data:www-data custom/plugins/ShopBite

Problem: Database Migrations Failed

Symptoms:

  • Error: "Migration failed"
  • Tables not created

Solutions:

# Run migrations manually
bin/console database:migrate --all ShopBite --force

# Check database permissions
mysql -u root -p
GRANT ALL PRIVILEGES ON shopware.* TO 'shopware'@'localhost';
FLUSH PRIVILEGES;

Problem: API Endpoints Not Reachable

Symptoms:

  • 404 error on API calls
  • Endpoints not available

Solutions:

# Clear route cache
bin/console router:cache:warmup

# Re-activate plugin
bin/console plugin:deactivate ShopBite
bin/console plugin:activate ShopBite

# Check API permissions
bin/console acl:role:list

Problem: Composer Installation Failed

Symptoms:

  • Error: "Could not find package shopbite-de/shopware-plugin"
  • Composer installation aborts

Solutions:

# Clear Composer cache
composer clear-cache

# Update Packagist
composer update

# Manual installation
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip

Uninstallation

Deactivate Plugin

# Deactivate plugin
bin/console plugin:deactivate ShopBite

Uninstall Plugin

# Uninstall plugin
bin/console plugin:uninstall ShopBite

# Clean data (optional)
bin/console plugin:uninstall ShopBite --keep-user-data=false

Manual Cleanup

# Remove plugin directory
rm -rf custom/plugins/ShopBite

# Clear cache
bin/console cache:clear

# Clean database (optional)
mysql -u shopware -p shopware -e "DROP TABLE IF EXISTS shopbite_business_hour, shopbite_holiday;"

Next Steps