Jak zastąpić blok podstawowy, model i kontroler w Magento2


49

Utknąłem w nadrzędnym modelu rdzenia Bloki i kontrolery w Magento2. Czy ktoś może w tym pomóc?

Weźmy na przykład pasek narzędzi listy, w którym muszę dodać nową opcję sortowania o nazwie sortuj według najpopularniejszych . Jak mogę to dodać? Myślę, że do tego musimy dodać opcję na poziomie bloku i warunek na List.phppoziomie kolekcji.


1
Przesłanianie klas podstawowych jest złym pomysłem i można to zrobić na wiele różnych sposobów. Czy możesz opisać swój konkretny przypadek?
KAndy

@KAndy: - weźmy przykład paska narzędzi listy, na którym muszę dodać nową opcję sortowania o nazwie sortuj według najpopularniejszych, a następnie jak ją dodać. Mam nadzieję, że do tego musimy dodać opcję na poziomie bloku i warunek na poziomie kolekcji List.php
Pradeep Kumar

Musisz dokładnie użyć po wykonaniu wtyczki w \ Magento \ Catalog \ Block \ Product \ ProductList \ Toolbar :: getAvailableOrders. Jeśli jakikolwiek inny użyje wtyczek, klient otrzymuje wszystkie zamówienia. w przypadku korzystania z przepisywania, występują konflikty modułów i jeden moduł nie będzie działał
KAndy 15.10.15

@KAndy: - czy możesz podać przykładowy kod, nie otrzymuję wtyczki, potrzebuję di.xml i kodu php wtyczki, jak to działa, a także jak dodać nową kolumnę do tabeli administracyjnej za pomocą wtyczki ex grid - pomóż mi w wtyczce ex code
Pradeep Kumar

@Kandy: - udostępnij przykładowy kod wtyczki w modelu produktu, dodaj tekst z nazwą produktu get) ()
Pradeep Kumar

Odpowiedzi:


30

Magento2 dał bardzo dobrą koncepcję o nazwie Plugin

możemy zrobić to, co kiedykolwiek po i przed funkcją podstawową, a także mamy jeszcze jedną wywoływaną wokół, która zrobi zarówno przed, jak i poniżej, kod, który obejmie wszystkie informacje

Utwórz plik di.xml w Mymodule / etc / di.xml

<?xml version="1.0"?>
<!--
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
-->
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../lib/internal/Magento/Framework/ObjectManager/etc/config.xsd">
   <type name="Magento\Catalog\Block\Product\View">
        <plugin name="inroduct-custom-module" type="Sugarcode\Test\Block\Plugin\Product\View" sortOrder="1"/>
    </type>
    <type name="Magento\Catalog\Model\Product">
        <plugin name="getname-test-module" type="Sugarcode\Test\Model\Plugin\Product" sortOrder="10"/>
    </type>
</config>

w tym wziąłem przykład modelu produktu i bloku widoku produktu

Użyłem w bloku widoku produktu, który jest dowolną funkcją, użyj prefiksu wokół, a następnie upewnij się, że 2 parametr powinien być pierwszy, który to obiekt, którego używasz 2. zamknięcie, które zachowuje stare informacje o zwrocie

<?php
namespace Sugarcode\Test\Block\Plugin\Product;

class View 
{ 
    public function aroundGetProduct(\Magento\Catalog\Block\Product\View $subject, \Closure $proceed)
    {

        echo 'Do Some Logic Before <br>';
        $returnValue = $proceed(); // it get you old function return value
        //$name='#'.$returnValue->getName().'#';
        //$returnValue->setName($name);
        echo 'Do Some Logic  After <br>';
        return $returnValue; // if its object make sure it return same object which you addition data
    }


}

W modelu i używany przed i po nim jest

<?php
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
namespace Sugarcode\Test\Model\Plugin;

class Product
{        
    public function beforeSetName(\Magento\Catalog\Model\Product $subject, $name)
    {
        return array('(' . $name . ')');
    }

     public function afterGetName(\Magento\Catalog\Model\Product $subject, $result)
    {
        return '|' . $result . '|';
    }

}

w ten sposób możemy zachować stary kod, więc jeśli jutro podstawowy kod Magento zostanie zaktualizowany, będziemy mieli zarówno nowy zaktualizowany kod, jak i naszą niestandardową logikę, jeśli bezpośrednio zastąpimy, stracimy nowy zaktualizowany kod tej funkcji lub pliku :-)

http://devdocs.magento.com/guides/v2.0/extension-dev-guide/plugins.html


Co jeśli chcesz dodać nową metodę do klasy? Poza preferencjami jaką mamy opcję?
MagePsycho

@MagePsycho: - jeśli masz coś nowego, oznacza to, że wychodzi z Magento. jeśli jego blok tworzy nowy blok i rozszerza go od rdzenia, ale bez preferencji. jeśli jakiś model, to napisz sekwencję, mam nadzieję, że nie ma innej drogi
Pradeep Kumar,

19

W końcu to dostałam !!!!
Wykonuję poniższe kroki, aby zastąpić blok, kontroler i model. Wziąłem przykład modelu produktu i widoku produktu Blok i podgląd kontrolera / działania

Utwórz plik o nazwie di.xml w swoim /etc/di.xml

<?xml version="1.0"?>
<!--
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
-->
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../lib/internal/Magento/Framework/ObjectManager/etc/config.xsd">
    <preference for="Magento\Catalog\Model\Product" type="Sugarcode\Test\Model\Product" />
    <preference for="Magento\Catalog\Block\Product\View" type="Sugarcode\Test\Block\Product\View" />
    <preference for="Magento\Catalog\Controller\Product\View" type="Sugarcode\Test\Controller\Product\View" />
</config>

Następnie utworzyłem plik modelu w /Model/Product.php

<?php
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
namespace Sugarcode\Test\Model;

class Product extends \Magento\Catalog\Model\Product
{
    /**
     * Get product name
     *
     * @return string
     * @codeCoverageIgnoreStart
     */
    public function getName()
    {
        return $this->_getData(self::NAME).'Local';
    }    
}

Następnie utworzyłem plik bloku w /Block/Product/View.php

<?php
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
namespace Sugarcode\Test\Block\Product;
/**
 * Product View block
 * @SuppressWarnings(PHPMD.CouplingBetweenObjects)
 */
class View extends \Magento\Catalog\Block\Product\View
{


    /**
     * Retrieve current product model
     *
     * @return \Magento\Catalog\Model\Product
     */
    public function getProduct()
    {
       echo 'Local Block';
       if (!$this->_coreRegistry->registry('product') && $this->getProductId()) {
            $product = $this->productRepository->getById($this->getProductId());
            $this->_coreRegistry->register('product', $product);
        }
        return $this->_coreRegistry->registry('product');
    }


}

Teraz utwórz kontroler widoku produktu /Controller/Product/View.php

<?php
/**
 *
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
namespace Sugarcode\Test\Controller\Product;

class View extends \Magento\Catalog\Controller\Product\View
{

    /**
     * Product view action
     *
     * @return \Magento\Framework\Controller\Result\Forward|\Magento\Framework\Controller\Result\Redirect
     */
    public function execute()
    {
        // Get initial data from request
       echo 'I Am in Local Controller';
       $categoryId = (int) $this->getRequest()->getParam('category', false);
        $productId = (int) $this->getRequest()->getParam('id');
        $specifyOptions = $this->getRequest()->getParam('options');

        if ($this->getRequest()->isPost() && $this->getRequest()->getParam(self::PARAM_NAME_URL_ENCODED)) {
            $product = $this->_initProduct();
            if (!$product) {
                return $this->noProductRedirect();
            }
            if ($specifyOptions) {
                $notice = $product->getTypeInstance()->getSpecifyOptionMessage();
                $this->messageManager->addNotice($notice);
            }
            if ($this->getRequest()->isAjax()) {
                $this->getResponse()->representJson(
                    $this->_objectManager->get('Magento\Framework\Json\Helper\Data')->jsonEncode([
                        'backUrl' => $this->_redirect->getRedirectUrl()
                    ])
                );
                return;
            }
            $resultRedirect = $this->resultRedirectFactory->create();
            $resultRedirect->setRefererOrBaseUrl();
            return $resultRedirect;
        }

        // Prepare helper and params
        $params = new \Magento\Framework\Object();
        $params->setCategoryId($categoryId);
        $params->setSpecifyOptions($specifyOptions);

        // Render page
        try {
            $page = $this->resultPageFactory->create(false, ['isIsolated' => true]);
            $this->viewHelper->prepareAndRender($page, $productId, $this, $params);
            return $page;
        } catch (\Magento\Framework\Exception\NoSuchEntityException $e) {
            return $this->noProductRedirect();
        } catch (\Exception $e) {
            $this->_objectManager->get('Psr\Log\LoggerInterface')->critical($e);
            $resultForward = $this->resultForwardFactory->create();
            $resultForward->forward('noroute');
            return $resultForward;
        }
    }
}

Dla mnie działa dobrze :-)


6

Istnieją dwa kroki do zastąpienia pliku bloku, modelu i kontrolera

1) Dodaj preferencje w di.xml

2) Utwórz plik bloku, modelu i kontrolera w swoim module

Przestrzeń nazw: Prince

Nazwa modułu: Helloworld

Na przykład, aby zastąpić katalog ListProduct produktu z katalogu

1) Utwórz plik di.xml w folderzePrince/Helloworld/etc

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
 <preference for="Magento\Catalog\Model\Product" type="Prince\Helloworld\Model\Rewrite\Catalog\Product" />
</config>

2) Utwórz ListProduct.php w folderzePrince/Helloworld/Block/Rewrite/Product

<?php
    namespace Prince\Helloworld\Block\Rewrite\Product;

    class ListProduct extends \Magento\Catalog\Block\Product\ListProduct
    {
        public function _getProductCollection()
        {
            // Do your code here
        }
    }

Na przykład, aby zastąpić katalogowy model produktu.

1) Dodaj preferencje w di.xml wPrince/Helloworld/etc

<preference for="Magento\Catalog\Model\Product" type="Prince\Helloworld\Model\Rewrite\Catalog\Product" /> 

2) Utwórz plik modelu Product.php w folderze Prince/Helloworld/Model/Rewrite/Catalog

<?php
namespace Prince\Helloworld\Model\Rewrite\Catalog;

class Product extends \Magento\Catalog\Model\Product
{
    public function isSalable()
    {
        // Do your code here

        return parent::isSalable();
    }

}

Nadrzędny kontroler

1) Dodaj preferencje w di.xml wPrince/Helloworld/etc

<preference for="Magento\Catalog\Controller\Product\View" type="Prince\Helloworld\Controller\Rewrite\Product\View" />

2) Utwórz View.php w folderzePrince/Helloworld/Controller/Rewrite/Product

class View extends \Magento\Catalog\Controller\Product\View
{
    public function execute()
    {
        // Do your stuff here
        return parent::execute();
    }
}

Możesz zastąpić inne bloki, modele i kontrolery, stosując to samo podejście.


Czy po dodaniu kontrolera, modelu i bloku musimy dodać przepisywanie? Dla mnie bez dodawania przepisywanie również działało.
sagar sapkota

@sagarsapkota Tak, możesz bezpośrednio używać kontrolera, modelu i bloku bez przepisywania folderu.
Prince Patel,

4

Mała korekta, ale duża użyteczność, nie musimy tworzyć n liczby plików dla każdej funkcji w koncepcji wtyczek. Dla jednego modułu wystarczy jeden plik wtyczki, abyś mógł rozszerzyć cały moduł, wszystkie modele i bloki oraz kontroler kompletnego Magento, to sam sprawdzi poniższy kod

<?xml version="1.0"?>
<!--
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
-->
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../lib/internal/Magento/Framework/ObjectManager/etc/config.xsd">

    <type name="Magento\Catalog\Block\Product\View">
        <plugin name="inroduct-custom-module" type="Sugarcode\Test\Model\Plugin\Product" sortOrder="1"/>
    </type>
    <type name="Magento\Catalog\Model\Product">
        <plugin name="getname-test-module" type="Sugarcode\Test\Model\Plugin\Product" sortOrder="10"/>
    </type>
    <type name="Magento\Catalog\Controller\Product\View">
        <plugin name="product-cont-test-module" type="Sugarcode\Test\Model\Plugin\Product" sortOrder="10"/>
    </type>
</config>

oraz we wtyczce pliku php

<?php
/**
 * Copyright © 2015 Magento. All rights reserved.
 * See COPYING.txt for license details.
 */
namespace Sugarcode\Test\Model\Plugin;

class Product
{        
    public function beforeSetName(\Magento\Catalog\Model\Product $subject, $name)
    {
        return array('(' . $name . ')');
    }

     public function afterGetName(\Magento\Catalog\Model\Product $subject, $result)
    {
        return '|' . $result . '|';
    } 
    public function aroundGetProduct(\Magento\Catalog\Block\Product\View $subject, \Closure $proceed)
    {

        echo 'Do Some Logic Before <br>';
        $returnValue = $proceed(); // it get you old function return value
        $name='#'.$returnValue->getName().'#';
        $returnValue->setName($name);
        echo 'Do Some Logic  After <br>';
        return $returnValue;// if its object make sure it return same object which you addition data
    }
    public function aroundExecute(\Magento\Catalog\Controller\Product\View $subject, \Closure $proceed)
    {
        echo 'I Am in Local Controller Before <br>';
        $returnValue = $proceed(); // it get you old function return value
        //$name='#'.$returnValue->getName().'#';
        //$returnValue->setName($name);
        echo 'I Am in Local Controller  After <br>';
        return $returnValue;// if its object make sure it return same object which you addition data
    }
}

Magento2 Rocks


Cześć Pradeep - przesłałeś trzy odpowiedzi na to pytanie - prawdopodobnie warto byłoby połączyć je w jedną odpowiedź
Robbie Averill,

Próbowałem z tą odpowiedzią, pokazuje błąd Uncaught Error: Call to undefined method Magento\\Backend\\Model\\View\\Result\\Redirect\\Interceptor::getEntityId()Tutaj \Clousure $proceeddostaje obejct zMagento\\Backend\\Model\\View\\Result\\Redirect\\Interceptor
Praful Rajput

3

Możesz bezpośrednio rozszerzyć klasę magento bloku lub kontrolera w swoim niestandardowym bloku lub kontrolerze. Na przykład, rozszerzając model faktury PDF w moim module niestandardowym, aby zmienić logo faktury Generowanie pliku PDF w taki sam sposób, jak można zastąpić blok lub kontroler. aby utworzyć plik di.xml i nie trzeba ustawiać preferencji.

class Invoice extends \Magento\Sales\Model\Order\Pdf\Invoice
{


    /**
     * Return PDF document
     *
     * @param array|Collection $invoices
     * @return \Zend_Pdf
     */
    public function getPdf($invoices = [])
    {

        $this->_beforeGetPdf();
        $this->_initRenderer('invoice');

        $pdf = new \Zend_Pdf();
        $this->_setPdf($pdf);
        $style = new \Zend_Pdf_Style();
        $this->_setFontBold($style, 10);

        foreach ($invoices as $invoice) {
            if ($invoice->getStoreId()) {
                $this->_localeResolver->emulate($invoice->getStoreId());
                $this->_storeManager->setCurrentStore($invoice->getStoreId());
            }
            $page = $this->newPage();
            $order = $invoice->getOrder();
            /* Add image */
            $this->insertCustomLogo($page, $invoice->getStore());
            /* Add address */
            $this->insertCustomAddress($page, $invoice->getStore());
            /* Add head */

            $this->insertOrder(
                $page,
                $order,
                $this->_scopeConfig->isSetFlag(
                    self::XML_PATH_SALES_PDF_INVOICE_PUT_ORDER_ID,
                    \Magento\Store\Model\ScopeInterface::SCOPE_STORE,
                    $order->getStoreId()

                )
            );

            /* Add document text and number */
            $this->insertDocumentNumber($page, __('Invoice # ') . $invoice->getIncrementId());
            /* Add table */

            $this->_drawHeader($page);
            /* Add body */

            foreach ($invoice->getAllItems() as $item) {
                if ($item->getOrderItem()->getParentItem()) {
                    continue;
                }

                /* Draw item */
                $this->_drawItem($item, $page, $order);

                $page = end($pdf->pages);
            }

            /* Add totals */
            $this->insertTotals($page, $invoice);
            if ($invoice->getStoreId()) {
                $this->_localeResolver->revert();
            }
        }

        $this->_afterGetPdf();
        return $pdf;
    } 

   protected function insertCustomLogo(&$page, $store = null)
   {

     $image='demo.png'

     if ($image) {
        $imagePath = '/logo/' . $image;
        if ($this->_mediaDirectory->isFile($imagePath)) {
            $image = \Zend_Pdf_Image::imageWithPath($this->_mediaDirectory->getAbsolutePath($imagePath));
            $top = 830;
            //top border of the page
            $widthLimit = 270;
            //half of the page width
            $heightLimit = 270;
            //assuming the image is not a "skyscraper"
            $width = $image->getPixelWidth();
            $height = $image->getPixelHeight();

            //preserving aspect ratio (proportions)
            $ratio = $width / $height;
            if ($ratio > 1 && $width > $widthLimit) {
                $width = $widthLimit;
                $height = $width / $ratio;
            } elseif ($ratio < 1 && $height > $heightLimit) {
                $height = $heightLimit;
                $width = $height * $ratio;
            } elseif ($ratio == 1 && $height > $heightLimit) {
                $height = $heightLimit;
                $width = $widthLimit;
            }

            $y1 = $top - $height;
            $y2 = $top;
            $x1 = 25;
            $x2 = $x1 + $width;

            //coordinates after transformation are rounded by Zend
            $page->drawImage($image, $x1, $y1, $x2, $y2);

            $this->y = $y1 - 10;
        }
    }
}

}


Czy to naprawdę droga do M2?
Maks.

Sztuką w Magento 2 jest zdefiniowanie preferencji w di.xml. Brakuje mi tej dość istotnej części w twojej odpowiedzi ...
7ochem

3
  • Deweloper / Helloworld / register.php

    
    \Magento\Framework\Component\ComponentRegistrar::register(
        \Magento\Framework\Component\ComponentRegistrar::MODULE,
        'Developer_Helloworld',
        __DIR__
    );
  • Deweloper / Helloworld / etc / module.xml

    <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
        <module name="Developer_Helloworld" setup_version="1.0.0">
        </module>
    </config>

  • Deweloper / Helloworld / etc / di.xml

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">    
    <preference for="Magento\Catalog\Controller\Product\View" type="Developer\Helloworld\Controller\Catalog\Product\View" />
</config>

  • Deweloper / Helloworld / Kontroler / Katalog / Produkt / View.php

    namespace Developer\Helloworld\Controller\Catalog\Product;
    class View extends \Magento\Catalog\Controller\Product\View
    {
        public function execute(){
            echo '__TEST__';exit;
        }
    }
mam nadzieję, że to pomocne

2

Klasę akcji można przepisać w taki sam sposób, jak w Magento 1. W Magento 1 mieliśmy beforeatrybut wokół tagów<routers>..<args><modules><... before="Mage_Catalog">Namespace_MyModule ..

W [module path]/etc/[nothing|adminhtml|frontend]/routes.xml:

<config>
    <router id="[admin|standard|]">
        <route id="catalog" frontName="catalog">
            <module name="Namespace_MyModule" before="Magento_Catalog"/>
        </route>
    </router>
</config>

A klasa akcji \Namespace\MyModule\Controller\[same path of action as in core module]\SameActionName.phpgdzieclass SameActionName.php extends \Magento\Catalog\...\SameActionName

To jest moduł Magento_Catalog, plik Magento\Catalog\etc\adminhtml\routes.xmlrejestrujący nową trasę w adminie :

<router id="admin">
    <route id="catalog" frontName="catalog">
        <module name="Magento_Catalog" before="Magento_Backend" />
    </route>
</router>

http://devdocs.magento.com/guides/v2.1/extension-dev-guide/routing.html

Aby zastąpić akcję kontrolera na trasie niestandardową, dodaj klasę kontrolera niestandardowego przed kontrolerem oryginalnym.

Niestandardowy kontroler i akcja powinny mieć takie same nazwy jak oryginalne.

System przetwarza niestandardowy kontroler przed oryginałem, podczas gdy trasa pozostaje taka sama.

Jeśli musisz zresetować trasę i projekt, przekaż przetwarzanie żądania na inną trasę:

$this->_forward('other/controller/action')

Aby usunąć działanie kontrolera, przekaż do noroute, na przykład w app / code / Company / SomeExtension / Controller / Account.php:

Nie uważam, aby preferencje lub wtyczki do klas Action były dobrym pomysłem najlepszych praktyk Magento. I może być więcej.


0

Aby zastąpić klasę bezpośrednio, musisz użyć preferencji. Zobacz więcej na temat dokumentacji programistów: https://devdocs.magento.com/guides/v2.0/extension-dev-guide/build/di-xml-file.html#abstraction-implementation-mappings
Przez większość czasu używamy przechwytywaczy (wtyczki), ponieważ jest to najlepsza praktyka przepisywania lub dodawania części modyfikacji. Zobacz dokumentacje programistów: https://devdocs.magento.com/guides/v2.0/extension-dev-guide/plugins.html

Zachowując przykład sortowania elementów listy poprzez dodanie nowego porządku sortowania „Najpopularniejsze” Zapewniam cię najlepszy sposób modyfikacji wyniku.
Utwórz niestandardowy moduł i utwórz konfigurację app/code/Arsal/SortOption/etc/module.xml:

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
   <module name="Arsal_SortOption" setup_version="1.0.0" />
</config> 

Teraz zarejestruj swój moduł app/code/Arsal/SortOption/registration.php:

<?php
 \Magento\Framework\Component\ComponentRegistrar::register(
     \Magento\Framework\Component\ComponentRegistrar::MODULE,
     'Arsal_SortOption',
      __DIR__
 );

Teraz utwórz di.xml app/code/Arsal/SortOption/etc/di.xml:

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Catalog\Block\Product\ProductList\Toolbar">
       <plugin name="toolbar_instance" type="Arsal\SortOption\Block\Product\ProductList\Toolbar" />
    </type>
</config>

Teraz utwórz klasę bloków Arsal\SortOption\Block\Product\ProductListToolbar.php:

<?php
namespace Arsal\SortOption\Block\Product\ProductList;

class Toolbar {

    public function afterGetAvailableOrders (
        \Magento\Catalog\Block\Product\ProductList\Toolbar $subject, $result
    ) {
        $result ['most_popular'] = 'most popular';
        return $result;
    }

Spowoduje to dodanie niestandardowej opcji sortowania do listy sortowania. wprowadź opis zdjęcia tutaj }

Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.