Guppy Theme

View Plugin

The DmfGuppyTheme is the base theme for all Guppy projects. It extends the Shopware 6 Storefront with optimized templates, custom fields, and helpful console commands.

On this page:

• Requirements
• Installation
• Features
• Custom Fields
  • Download Files for Products
  • Footer Options for Payment/Shipping Methods
• Console Commands
  • guppy:theme:create
  • guppy:install:plugins
• Theme Configuration
• Further Documentation

---

Requirements

• Shopware 6.7.0 or higher
• PHP 8.2 or higher

Installation

composer require dmf/sw6-guppy-theme
bin/console plugin:install --activate DmfGuppyTheme
bin/console theme:change --all DmfGuppyTheme
bin/console cache:clear

---

Features

• Optimized Storefront: Improved templates and components
• Custom Fields: Additional fields for products and payment/shipping methods
• Console Commands: Tools for theme development and plugin installation
• SCSS Architecture: Modular and maintainable stylesheets
• Accessibility: WCAG 2.1 compliant components

---

Custom Fields

The Guppy Theme automatically installs custom field sets for extended functionality.

Download Files for Products

Custom Field Set: guppy_download_tab_set

Allows adding up to 5 download files per product (e.g., datasheets, manuals).

Field	Type	Description
guppy_download_title_1 - guppy_download_title_5	Text	Download title
guppy_download_file_1 - guppy_download_file_5	Media	The download file

Usage in Admin:

1. Open a product in Admin
2. Switch to the Specifications tab
3. Scroll to Download Files (Guppy)
4. Enter title and file for each download

Footer Options for Payment/Shipping Methods

Custom Field Set: guppy_footer_options

Controls the display of payment and shipping methods in the footer.

Field	Type	Description
guppy_hide_in_footer	Boolean	Hide method in footer
guppy_alternative_label	Text	Alternative label for tooltip

Usage in Admin:

1. Open Settings → Shop → Payment Methods or Shipping Methods
2. Select a method
3. Scroll to Footer Options
4. Configure visibility and label

---

Console Commands

guppy:theme:create

Creates a new child theme based on the Guppy Theme.

bin/console guppy:theme:create

The command guides you interactively through theme creation:

1. Theme Name: Name of the new theme (e.g., MyShopTheme)
2. Namespace: PHP namespace (e.g., MyShop\Theme)
3. Directory: Target directory for the theme

Generated Structure:

custom/plugins/MyShopTheme/
├── src/
│   ├── MyShopTheme.php
│   └── Resources/
│       ├── app/
│       │   └── storefront/
│       │       └── src/
│       │           ├── main.js
│       │           └── scss/
│       │               └── base.scss
│       └── views/
│           └── storefront/
├── composer.json
└── theme.json

guppy:install:plugins

Installs and activates all Guppy plugins in the correct order.

bin/console guppy:install:plugins

Installed Plugins:

• DmfGuppyEmotionworldElements
• DmfCmsCustomGrids
• DmfDropdownNavigation
• DmfCustomFonts
• (additional optional plugins)

---

Theme Configuration

The Guppy Theme offers extensive configuration options in Admin under:

Path: Sales Channels → [Sales Channel] → Theme → Theme Configuration

See Configuration Options for the complete reference.

---

Further Documentation

• SCSS Architecture
• Templating
• JavaScript Plugins
• Emotionworld Elements