swissup/core 1.4.6

Swissup core module. It's purpose is to add menu and config placeholders

Type

magento2-module

License

OSL-3.0

Requires

None

Requires (dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

Core

Contents

  1. Installation
  2. Swissup Installer Usage
  3. Swissup Upgrade Class
  4. Popup Message Manager

Installation

cd <magento_root>
composer config repositories.swissup/core vcs [email protected]:swissup/core.git
composer require swissup/core --prefer-source
bin/magento module:enable Swissup_Core
bin/magento setup:upgrade

Swissup Installer Usage

Swissup installer is a class that collects Swissup Upgrades from all module dependencies and run them, if needed.

Lets see the example of how the Argento theme installer is working:

$module = $this->_objectManager->create('Swissup\Core\Model\Module');
$module->load('Swissup_ArgentoDefault')
    ->setNewStores([0])
    ->up();

What does this code do?

  1. Create Swissup\Core\Model\Module object.
  2. Load module info for Swissup_ArgentoDefault module from composer.json file.
  3. Set the store to use (All Stores).
  4. Run installer:
    1. Search for Swissup\Upgrade classes for all depends of Swissup_ArgentoDefault module.
    2. Run getOperations and up command for each of the found upgrade class.
    3. Run getOperations and up command of Swissup_ArgentoDefault upgrade class.

Swissup Upgrade Class

When module or theme needs to run some extra logic for specified store views, it's very handy to use Swissup\Upgrade class, which allows to create and automatically backup various content types and configuration.

Why not to use Magento DataUpgrade? - It does not allow to run upgrade multiple times (reinstall) - It does not have built-in methods to change store configuration - It does not support content backups

Swissup upgrades — are migrations, located at <module_dir>/Upgrades directory. Upgrade class must implement Swissup\Core\Api\Data\ModuleUpgradeInterface.

Upgrade examples:

Swissup/ArgentoDefault/Upgrades/1.0.0_initial_installation.php
Swissup/ArgentoDefault/Upgrades/1.0.1_add_callout_blocks.php
Swissup/ArgentoDefault/Upgrades/1.1.0_create_featured_products.php

Upgrade naming conventions

1.0.0       _               initial_installation   .php
^ version   ^ Separator     ^ ClassName            ^ file extension

Class example:

<?php

namespace Swissup\ArgentoDefault\Upgrades;

class InitialInstallation extends \Swissup\Core\Model\Module\Upgrade
{
    public function up()
    {   
        // This method is optional.
        // Additional logic may be placed here.
    }

    public function getCommands()
    {
        return [
            'Configuration' => [
                'prolabels/on_sale/product/active'  => 1,
                'prolabels/on_sale/category/active' => 1,
                'prolabels/is_new/product/active'   => 1,
                'prolabels/is_new/category/active'  => 1,
            ],

            'CmsBlock' => [
                'header_callout' => [
                    'title' => 'header_callout',
                    'identifier' => 'header_callout',
                    'is_active' => 1,
                    'content' => 'content'
                ]
            ]

            'ProductAttribute' => [
                [
                    'attribute_code' => 'featured',
                    'frontend_label' => array('Featured'),
                    'default_value'  => 0
                ]
            ],

            'Products' => [
                'featured'       => 6,
                'news_from_date' => 6
            ]
        ];
    }
}

Supported Commands

Key/ClassName Description
Configuration Update store configuration
CmsBlock Create/backup cms blocks
CmsPage Create/backup cms pages
Easyslide Create slider if it does not exists
ProductAttribute Create attribute if it does not exists
Easybanner Create placeholders and banners
Products Create featured, new, special, and any other products

Popup Message Manager

Popup message manager allows to show regular Magento messages with additional information in popup window.

Popup Message Example

Usage example

Inject \Swissup\Helper\PopupMessageManager component into your controller action and use it instead of built-in \Magento\Framework\Message\Manager:

$this->popupMessageManager->addError(
    __('Decoding failed: Syntax error'),
    $popupText,
    $popupTitle
);