README

A Magento 2 module that automatically creates store views for each Swissup theme and applies the corresponding theme to them, including running theme-specific installers.

🎯 What it does

This module streamlines the process of setting up multiple Swissup themes by:

• Creating store views for each available Swissup theme
• Applying themes automatically to their corresponding store views
• Running theme installers to install CMS content, blocks, sliders, and configurations
• Performing maintenance tasks like setup upgrade and reindexing

📋 Requirements

• Magento 2.4+ (tested on 2.4.x)
• Swissup themes installed via Composer
• PHP 7.4+ or 8.x
• Swissup Marketplace module

🚀 Installation

Method 1: Composer (Recommended)

# Install via Composer
composer require swissup/module-theme-store-views

# Enable the module
php bin/magento module:enable Swissup_ThemeStoreViews

# Run setup upgrade
php bin/magento setup:upgrade

# Clear cache and compile
php bin/magento cache:flush
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Method 2: Manual Installation

1. Download or clone this repository
2. Copy the module to app/code/Swissup/ThemeStoreViews/
3. Run the following commands:

# Enable the module
php bin/magento module:enable Swissup_ThemeStoreViews

# Run setup upgrade
php bin/magento setup:upgrade

# Clear cache
php bin/magento cache:flush

📖 Usage

Basic Command

Create store views for all Swissup themes:

php bin/magento swissup:theme:create-storeviews

Command Options

Examples

# Create store views (skips existing ones)
php bin/magento swissup:theme:create-storeviews

# Force reinstall themes for all store views
php bin/magento swissup:theme:create-storeviews --reinstall

# Show help
php bin/magento swissup:theme:create-storeviews --help

🎨 Supported Themes

The module automatically detects and processes these Swissup themes:

⚡ Features

🏪 Store View Creation

• Automatically generates valid store view codes
• Uses theme titles as store view names
• Assigns to default website and store group
• Sets appropriate sort order and status

🎨 Theme Application

• Applies the correct theme to each store view
• Updates design configuration automatically
• Maintains theme-store view relationships

📦 Theme Installation

• Detects etc/marketplace/installer.xml files
• Runs Swissup Marketplace installers automatically
• Installs theme-specific content:
  • CMS Pages
  • CMS Blocks
  • Sliders (EasySlider)
  • Product Attributes
  • Configuration Settings
  • Media Files
  • Product Collections

🔧 Maintenance Tasks

• Runs setup:upgrade --safe-mode=1
• Executes indexer:reindex
• Clears all cache types
• Provides progress feedback

🛡️ Safety Features

• Skips existing store views by default
• Non-interactive execution
• Error handling and validation
• Progress bars and status updates

🎨 Enhanced CLI Experience (v1.0.2+)

• Professional Output: Colorful, styled headers with box borders
• Real-time Progress: Live progress bar showing current theme and statistics
• Color-coded Status: Green for success, yellow for warnings, red for errors
• Live Statistics: Current counts of created and skipped stores
• Professional Summary: Detailed completion report with statistics
• Step-by-step Feedback: Clear indicators for each post-processing step
• Enhanced Error Messages: Clear, colorful error reporting
• Emoji Indicators: Visual cues for different types of operations

🔍 How It Works

1. Discovery: Scans for installed Swissup themes
2. Validation: Checks if themes exist and are properly installed
3. Store Creation: Creates store views with proper codes and names
4. Theme Application: Assigns themes to their respective store views
5. Content Installation: Runs marketplace installers for theme content
6. Maintenance: Performs setup upgrade, reindexing, and cache clearing

📁 Module Structure

app/code/Swissup/ThemeStoreViews/
├── Console/
│   └── Command/
│       └── CreateThemeStoreViews.php    # Main command class
├── etc/
│   ├── di.xml                           # Dependency injection
│   └── module.xml                       # Module configuration
├── registration.php                     # Module registration
└── README.md                           # This documentation

🐛 Troubleshooting

Store View Already Exists

Issue: Store view with the same code already exists Solution: Use --reinstall flag to run installers on existing store views

php bin/magento swissup:theme:create-storeviews --reinstall

Theme Not Found

Issue: Theme not detected by the module Solution: Ensure the theme is properly installed and appears in:

php bin/magento theme:info

Installer Not Found

Issue: No installer.xml found for a theme Solution: This is normal - not all themes have installers. The module will skip installation for themes without etc/marketplace/installer.xml

Permission Issues

Issue: File permission errors during installation Solution: Ensure proper file permissions:

chmod -R 755 var/
chmod -R 755 pub/static/
chmod -R 755 pub/media/

Memory Issues

Issue: PHP memory limit exceeded Solution: The module automatically uses unlimited memory for heavy operations

📊 Output Example

╔══════════════════════════════════════════════════════════════════════════════════════╗
║                    🎨 Swissup Theme Store Views Creator                           ║
╚══════════════════════════════════════════════════════════════════════════════════════╝

🚀 Starting theme store views creation process...
📊 Website: Main Website (ID: 1)
🏪 Store Group: Main Website Store (ID: 1)

📋 Processing 18 themes...
10/18 [===============>------------]  55% Processing: Swissup/argento-pure2 (10/18) | Created: 8 | Skipped: 2

🔧 Found installer for theme: Argento Pure2
📦 Installing package: swissup/theme-frontend-argento-pure2
💻 Executing: php bin/magento marketplace:package:install swissup/theme-frontend-argento-pure2 --store=27 --no-interaction
[notice] Processing swissup/theme-frontend-argento-pure2
[info] Config: Update store parameters
[info] Cms Pages: Backup existing pages
[info] CMS PAGES: Create new pages
[info] Cms Blocks: Backup existing and create new blocks
✅ Command completed!

✅ Created store view: Argento Pure2 (argento_pure2)

18/18 [============================] 100% Complete (18/18) | Created: 16 | Skipped: 2

╔═══════════════════════════════════════════════════════════════════════════════╗
║                            📊 SUMMARY REPORT                               ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ ✅ Created:  16 store views                                                  ║
║ ⏭️  Skipped:   2 existing ones                                               ║
║ 📋 Total:    18 themes processed                                            ║
╚═══════════════════════════════════════════════════════════════════════════════╝

🔧 Post-processing steps: Running required maintenance tasks...

🚀 Step 1/3: Running setup:upgrade...
🔍 Step 2/3: Running reindex...
🧹 Step 3/3: Clearing cache...
✅ Cache cleared successfully!

🎉 SUCCESS! Theme store views setup completed successfully!
╔═══════════════════════════════════════════════════════════════════════════════╗
║                        🌟 PROCESS COMPLETE 🌟                              ║
╚═══════════════════════════════════════════════════════════════════════════════╝

🔗 Related Commands

# List all store views
php bin/magento store:list

# Check theme installation
php bin/magento theme:info

# Manual marketplace installation
php bin/magento marketplace:package:install swissup/theme-frontend-[theme-name] --store=[store-id]

# Manual setup and maintenance
php bin/magento setup:upgrade --safe-mode=1
php bin/magento indexer:reindex
php bin/magento cache:flush

📄 License

This module follows the same license as your Magento installation and Swissup modules.

💬 Support

For issues related to:

• This module: Contact your development team
• Swissup themes: Visit Swissup Documentation
• Magento core: Check Magento DevDocs

Version: 1.0.2
Compatible: Magento 2.4.x
Created: 2025