Quotation Process feature integration

Last updated: December 24, 2019

Edit on GitHub

Install Feature Core

Prerequisites

To start feature integration, overview and install the necessary features:

Name	Version
Spryker Core	201907.0
Cart	201907.0
Company Account	201907.0
Prices	201907.0
Persistent Cart	201907.0
Agent Assist	201907.0

1) Install Required Modules using Composer

Run the following command(s) to install the required modules:

composer require spryker-feature/quotation-process: "^201907.0" --update-with-dependencies

Verification

Make sure that the following modules were installed:

Module	Expected Directory
`QuoteRequest`	`vendor/spryker/quote-request`
`QuoteRequestExtension`	`vendor/spryker/quote-request-extension`
`QuoteRequestAgent`	`vendor/spryker/quote-request-agent`
`QuoteRequestDataImport`	`vendor/spryker/quote-request-data-import`

2) Set up Configuration

Add the following configuration to your project:

Configuration	Specification	Namespace
`QuoteConfig::getQuoteFieldsAllowedForSaving`	Used to allow saving quote request related fields of the quote to the database.	`Pyz\Zed\Quote`
`QuoteRequestConfig::getQuoteFieldsAllowedForSaving`	Used to define which quota data should be saved in the database during the request for quote process.	`Pyz\Zed\QuoteRequest`
Outdated quote request closing cronjob (See below in `config/Zed/cronjobs/jobs.php`)	Add cronjob that closes outdated quote requests.	-
Customer login access control regular expression (See below in `config/Shared/config_default.php`)	Used to close access for not logged in customers.	-

src/Pyz/Zed/Quote/QuoteConfig.php

<?php
 
namespace Pyz\Zed\Quote;
 
use Generated\Shared\Transfer\QuoteTransfer;
use Spryker\Zed\Quote\QuoteConfig as SprykerQuoteConfig;
 
class QuoteConfig extends SprykerQuoteConfig
{
    /**
     * @return array
     */
    public function getQuoteFieldsAllowedForSaving()
    {
        return array_merge(parent::getQuoteFieldsAllowedForSaving(), [
            QuoteTransfer::QUOTE_REQUEST_VERSION_REFERENCE,
            QuoteTransfer::QUOTE_REQUEST_REFERENCE,
        ]);
    }
}

@(Waring)(Verification)(Make sure that when you converted quote request to quote, JSON data in the database column spy_quote.quote_data of the corresponding quote contains quoteRequestVersionReference.)

src/Pyz/Zed/QuoteRequest/QuoteRequestConfig.php

<?php
 
namespace Pyz\Zed\QuoteRequest;
 
use Generated\Shared\Transfer\QuoteTransfer;
use Spryker\Zed\QuoteRequest\QuoteRequestConfig as SprykerQuoteRequestConfig;
 
class QuoteRequestConfig extends SprykerQuoteRequestConfig
{
    /**
     * @return array
     */
    public function getQuoteFieldsAllowedForSaving(): array
    {
        return array_merge(parent::getQuoteFieldsAllowedForSaving(), [
            QuoteTransfer::CUSTOMER_REFERENCE,
            QuoteTransfer::CUSTOMER,
            QuoteTransfer::STORE,
            QuoteTransfer::ITEMS,
            QuoteTransfer::TOTALS,
            QuoteTransfer::CURRENCY,
            QuoteTransfer::PRICE_MODE,
            QuoteTransfer::BUNDLE_ITEMS,
            QuoteTransfer::VOUCHER_DISCOUNTS,
            QuoteTransfer::CART_RULE_DISCOUNTS,
            QuoteTransfer::PROMOTION_ITEMS,
        ]);
    }
}

Verification

Make sure that, when you created quote request, JSON data in the database column `spy_quote_request_version.quote` of the corresponding quote request contains `customerReference`.

config/Zed/cronjobs/jobs.php

<?php
 
$stores = require(APPLICATION_ROOT_DIR . '/config/Shared/stores.php');
 
$allStores = array_keys($stores);
/* QuoteRequest */
$jobs[] = [
    'name' => 'close-outdated-quote-requests',
    'command' => '$PHP_BIN vendor/bin/console quote-request:close-outdated',
    'schedule' => '0 * * * *',
    'enable' => true,
    'run_on_non_production' => true,
    'stores' => $allStores,
];

Verification

Make sure that quote request with outdated **Valid Until** changes its status to closed within one hour.

config/Shared/config_default.php

<?php
 
$config[CustomerConstants::CUSTOMER_SECURED_PATTERN] = '(^/login_check$|^(/en|/de)?/customer($|/)|^(/en|/de)?/wishlist($|/)|^(/en|/de)?/shopping-list($|/)|^(/en|/de)?/quote-request($|/)|^(/en|/de)?/company(?!/register)($|/)|^(/en|/de)?/multi-cart($|/)|^(/en|/de)?/shared-cart($|/)|^(/en|/de)?/cart(?!/add)($|/)|^(/en|/de)?/checkout($|/))';

Verification

Make sure that `http://mysprykershop.com/quote-request` with not logged user redirects to the login page.

2) Set up the Database Schema and Transfer Objects

Run the following commands to apply database changes and generate entity and transfer changes:

console transfer:generate
console propel:install
console transfer:generate

Verification

Make sure that the following changes applied by checking your database:

Database Entity	Type	Event
`spy_quote_request`	table	created
`spy_quote_request_version`	table	created

Verification

Make sure that the following changes in transfer objects:

Transfer	Type	Event	Path
`SpyQuoteRequestEntity`	class	created	`src/Generated/Shared/Transfer/SpyQuoteRequestEntityTransfer`
`SpyQuoteRequestVersionEntity`	class	created	`src/Generated/Shared/Transfer/SpyQuoteRequestVersionEntityTransfer`
`CompanyUserCriteria`	class	created	`src/Generated/Shared/Transfer/CompanyUserCriteria`
`QuoteRequestFilter`	class	created	`src/Generated/Shared/Transfer/QuoteRequestFilter`
`QuoteRequestResponse`	class	created	`src/Generated/Shared/Transfer/QuoteRequestResponse`
`QuoteRequestCollection`	class	created	`src/Generated/Shared/Transfer/QuoteRequestCollection`
`QuoteRequestVersionCollection`	class	created	`src/Generated/Shared/Transfer/QuoteRequestVersionCollection`
`QuoteRequest`	class	created	`src/Generated/Shared/Transfer/QuoteRequest`
`QuoteRequestVersion`	class	created	`src/Generated/Shared/Transfer/QuoteRequestVersion`
`QuoteRequestVersionFilter`	class	created	`src/Generated/Shared/Transfer/QuoteRequestVersionFilter`

4) Add Translations

Append glossary according to your configuration:

src/data/import/glossary.csv

quote_request.status.waiting,Waiting,en_US
quote_request.status.waiting,Warten,de_DE
quote_request.status.in-progress,In Progress,en_US
quote_request.status.in-progress,Bearbeitung,de_DE
quote_request.status.ready,Ready,en_US
quote_request.status.ready,Bereit,de_DE
quote_request.status.canceled,Canceled,en_US
quote_request.status.canceled,Abgebrochen,de_DE
quote_request.status.closed,Closed,en_US
quote_request.status.closed,Geschlossen,de_DE
quote_request.status.draft,Draft,en_US
quote_request.status.draft,Entwurf,de_DE
quote_request.validation.success.canceled,Quote request canceled successfully.,en_US
quote_request.validation.success.canceled,Angebotsanfrage erfolgreich abgebrochen.,de_DE
quote_request.validation.converted_to_cart.success,Quote request converted to cart successfully.,en_US
quote_request.validation.converted_to_cart.success,Die Angebotsanfrage wurde erfolgreich in den Warenkorb konvertiert.,de_DE
quote_request.validation.error.not_exists,Quote Request not exists.,en_US
quote_request.validation.error.not_exists,Angebotsanfrage existiert nicht.,de_DE
quote_request.validation.error.wrong_status,Wrong Quote Request status for this operation.,en_US
quote_request.validation.error.wrong_status,Falscher Angebotsanforderungsstatus für diesen Vorgang.,de_DE
quote_request.validation.error.company_user_not_found,Company User not found.,en_US
quote_request.validation.error.company_user_not_found,Firmenbenutzer nicht gefunden.,de_DE
quote_request.validation.error.empty_cart,Quote request can't be created from empty cart.,en_US
quote_request.validation.error.empty_cart,Angebotsanfrage kann nicht aus leerem Einkaufswagen erstellt werden.,de_DE
quote_request.checkout.validation.error.version_not_found,Quote Request Version not found.,en_US
quote_request.checkout.validation.error.version_not_found,Angebotsanforderung Version nicht gefunden.,de_DE
quote_request.checkout.validation.error.not_found,Quote Request not found.,en_US
quote_request.checkout.validation.error.not_found,Angebotsanfrage nicht gefunden.,de_DE
quote_request.checkout.validation.error.wrong_status,The Request for Quote is in a wrong status at the moment.,en_US
quote_request.checkout.validation.error.wrong_status,Die Angebotsanfrage befindet sich zurzeit in einem falschen Status.,de_DE
quote_request.checkout.validation.error.wrong_version,The version of Request for Quote for this cart is outdated.,en_US
quote_request.checkout.validation.error.wrong_version,Die Version der Angebotsanfrage für diesen Warenkorb ist veraltet.,de_DE
quote_request.checkout.validation.error.wrong_valid_until,Request for Quote from which this cart was created is not valid anymore.,en_US
quote_request.checkout.validation.error.wrong_valid_until,"Angebotsanfrage, aus der dieser Warenkorb erstellt wurde, ist nicht mehr gültig.",de_DE
quote_request.checkout.convert.error.wrong_valid_until,Request for Quote is not valid anymore.,en_US
quote_request.checkout.convert.error.wrong_valid_until,Die Angebotsanfrage ist nicht mehr gültig.,de_DE
quote_request.update.validation.error.wrong_valid_until,The validity date of this request for quote is already passed. Please change the date to send to the customer.,en_US
quote_request.update.validation.error.wrong_valid_until,"Das Gültigkeitsdatum dieser Angebotsanfrage ist bereits abgelaufen. Bitte ändern Sie das Datum, um es an den Kunden zu senden.",de_DE

Run the following console command to import data:

console data:import glossary

Verification

Make sure that in the database the configured data are added to the `spy_glossary` table.

5) Set up Behavior

Set up Quote Request Workflow

Enable the following behaviors by registering the plugins:

Plugin	Specification	Prerequisites	Namespace
`QuoteRequestDatabaseStrategyPreCheckPlugin`	Disallows database strategy when editing quote items.	None	`Spryker\Client\QuoteRequest\Plugin\Quote`
`PersistentCartQuotePersistPlugin`	Makes full replacement of the customer quote.	None	`Spryker\Client\PersistentCart\Plugin`
`CloseOutdatedQuoteRequestConsole`	Registers console command for closing outdated quote requests.	None	`Spryker\Zed\QuoteRequest\Communication\Console`
`SanitizeQuoteRequestQuoteLockPreResetPlugin`	Sanitizes data related to request for quote in quote.	None	`Spryker\Zed\QuoteRequest\Communication\Plugin\Cart`
`SanitizeSourcePricesQuoteLockPreResetPlugin`	Sanitizes source prices in quote items.	None	`Spryker\Zed\PriceCartConnector\Communication\Plugin\Cart`

Pyz\Client\Quote\QuoteDependencyProvider.php

<?php
 
namespace Pyz\Client\Quote;
 
use Spryker\Client\Quote\QuoteDependencyProvider as BaseQuoteDependencyProvider;
use Spryker\Client\QuoteRequest\Plugin\Quote\QuoteRequestDatabaseStrategyPreCheckPlugin;
 
class QuoteDependencyProvider extends BaseQuoteDependencyProvider
{
    /**
     * @return \Spryker\Client\QuoteExtension\Dependency\Plugin\DatabaseStrategyPreCheckPluginInterface[]
     */
    protected function getDatabaseStrategyPreCheckPlugins(): array
    {
        return [
            new QuoteRequestDatabaseStrategyPreCheckPlugin(),
        ];
    }
}

Verification

Make sure editing quote request items does not trigger new quote creation in persistence.

Pyz\Client\PersistentCart\PersistentCartDependencyProvider.php

<?php
 
namespace Pyz\Client\PersistentCart;
 
use Spryker\Client\PersistentCart\PersistentCartDependencyProvider as SprykerPersistentCartDependencyProvider;
use Spryker\Client\PersistentCartExtension\Dependency\Plugin\QuotePersistPluginInterface;
use Spryker\Client\PersistentCart\Plugin\PersistentCartQuotePersistPlugin;
 
class PersistentCartDependencyProvider extends SprykerPersistentCartDependencyProvider
{
    /**
     * @return \Spryker\Client\PersistentCartExtension\Dependency\Plugin\QuotePersistPluginInterface
     */
    protected function getQuotePersistPlugin(): QuotePersistPluginInterface
    {
        return new PersistentCartQuotePersistPlugin();
    }
}

Verification

Make sure that you can edit quote request items.

Pyz\Zed\Console\ConsoleDependencyProvider.php

<?php
 
namespace Pyz\Zed\Console;
 
use Spryker\Zed\Console\ConsoleDependencyProvider as SprykerConsoleDependencyProvider;
use Spryker\Zed\Kernel\Container;
use Spryker\Zed\QuoteRequest\Communication\Console\CloseOutdatedQuoteRequestConsole;
 
 
class ConsoleDependencyProvider extends SprykerConsoleDependencyProvider
{
    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return \Symfony\Component\Console\Command\Command[]
     */
    protected function getConsoleCommands(Container $container)
    {
        $commands = [
            new CloseOutdatedQuoteRequestConsole(),
        ];
 
 
        return $commands;
    }
}

Verification

Make sure that status of quote request with outdated Valid Until changes to closed after you run the `console quote-request:close-outdated` command.

Pyz/Zed/Cart/CartDependencyProvider.php

<?php
 
namespace Pyz\Zed\Cart;
 
use Spryker\Zed\Cart\CartDependencyProvider as SprykerCartDependencyProvider;
use Spryker\Zed\PriceCartConnector\Communication\Plugin\Cart\SanitizeSourcePricesQuotePreUnlockPlugin;
use Spryker\Zed\QuoteApproval\Communication\Plugin\Cart\SanitizeQuoteApprovalPreQuoteUnlockPlugin;
use Spryker\Zed\QuoteRequest\Communication\Plugin\Cart\SanitizeQuoteRequestPreQuoteUnlockPlugin;
 
class CartDependencyProvider extends SprykerCartDependencyProvider
{
    /**
     * @return \Spryker\Zed\CartExtension\Dependency\Plugin\QuoteLockPreResetPluginInterface[]
     */
    protected function getQuoteLockPreResetPlugins(): array
    {
        return [
            new SanitizeQuoteRequestQuoteLockPreResetPlugin(),
            new SanitizeSourcePricesQuoteLockPreResetPlugin(),
        ];
    }
}

Verification

Make sure that when you make lock reset for a cart, quote request associated with it removed.

Install feature frontend

Prerequisites

To start feature integration, overview and install the necessary features:

Name	Version
Spryker Core	201907.0
Cart	201907.0
Company Account	201907.0
Prices	201907.0
Persistent Cart	201907.0
Agent Assist	201907.0

1) Install Require Modules using Composer

Run the following command(s) to install the required modules:

composer require spryker-feature/quotation-process: "^201907.0" --update-with-dependencies

Verification

Make sure that the following modules were installed:

Module	Expected Directory
`QuoteRequestWidget`	`vendor/spryker-shop/quote-request-widget`
`QuoteRequestPage`	`vendor/spryker-shop/quote-request-page`
`QuoteRequestPageExtension`	`vendor/spryker-shop/quote-request-page-extension`
`QuoteRequestAgentPage`	`vendor/spryker-shop/quote-request-agent-page`
`QuoteRequestAgentPageExtension`	`vendor/spryker-shop/quote-request-agent-page-extension`
`QuoteRequestAgentWidget`	`vendor/spryker-shop/quote-request-agent-widget`

2) Add Translations

Append glossary according to your configuration:

src/data/import/glossary.csv

quote_request_widget.request_for_quote,Request for Quote,en_US
quote_request_widget.request_for_quote,Angebotsanfrage,de_DE
quote_request_widget.request_for_quote.list.title,Requests for Quote,en_US
quote_request_widget.request_for_quote.list.title,Angebotsanfragen,de_DE
quote_request_page.quote_request,Request for Quote,en_US
quote_request_page.quote_request,Angebotsanfrage,de_DE
quote_request_page.quote_request.create,Create,en_US
quote_request_page.quote_request.create,Erstellen,de_DE
quote_request_page.quote_request_version.created,RfQ have got new version,en_US
quote_request_page.quote_request_version.created,Angebotsanfrage hat neue Version bekommen,de_DE
quote_request_page.quote_request.submit,Submit Request,en_US
quote_request_page.quote_request.submit,Anfrage Einreichen,de_DE
quote_request_page.quote_request.metadata.label.note,Notes,en_US
quote_request_page.quote_request.metadata.label.note,Anmerkungen,de_DE
quote_request_page.quote_request.metadata.label.delivery_date,Do not ship later than,en_US
quote_request_page.quote_request.metadata.label.delivery_date,Versenden Sie nicht später als,de_DE
quote_request_page.quote_request.metadata.label.purchase_order_number,Purchase order number,en_US
quote_request_page.quote_request.metadata.label.purchase_order_number,Bestellnummer,de_DE
quote_request_page.quote_request.violations.invalid_date,Date should be greater than current date.,en_US
quote_request_page.quote_request.violations.invalid_date,Date should be greater than current date.,de_DE
quote_request_page.quote_request.created,Quote request created successfully.,en_US
quote_request_page.quote_request.created,Angebotsanfrage erfolgreich erstellt.,de_DE
quote_request_page.quote_request.list.reference,RfQ,en_US
quote_request_page.quote_request.list.reference,AfA,de_DE
quote_request_page.quote_request.list.company,Company,en_US
quote_request_page.quote_request.list.company,Firma,de_DE
quote_request_page.quote_request.list.business_unit,Business unit,en_US
quote_request_page.quote_request.list.business_unit,Geschäftseinheit,de_DE
quote_request_page.quote_request.list.owner,Owner,en_US
quote_request_page.quote_request.list.owner,Inhaber,de_DE
quote_request_page.quote_request.list.total,Total,en_US
quote_request_page.quote_request.list.total,Gesamt,de_DE
quote_request_page.quote_request.list.date,Date,en_US
quote_request_page.quote_request.list.date,Datum,de_DE
quote_request_page.quote_request.list.status,Status,en_US
quote_request_page.quote_request.list.status,Status,de_DE
quote_request_page.quote_request.list.actions,Actions,en_US
quote_request_page.quote_request.list.actions,Aktionen,de_DE
quote_request_page.quote_request.labels.date,Date,en_US
quote_request_page.quote_request.labels.date,Datum,de_DE
quote_request_page.quote_request.labels.status,Status,en_US
quote_request_page.quote_request.labels.status,Status,de_DE
quote_request_page.quote_request.labels.valid_till,Valid Till (UTC),en_US
quote_request_page.quote_request.labels.valid_till,Gültig bis (UTC),de_DE
quote_request_page.quote_request.labels.hide_latest_version,Hide latest version from customer,en_US
quote_request_page.quote_request.labels.hide_latest_version,Die letzte Version vom Kunden verstecken,de_DE
quote_request_page.quote_request.labels.latest_version_is_hidden,The latest version is hidden from the customer,en_US
quote_request_page.quote_request.labels.latest_version_is_hidden,Die letzte Version ist dem Kunden verborgen,de_DE
quote_request_page.quote_request.labels.latest_version_is_visible,The latest version is visible to the customer,en_US
quote_request_page.quote_request.labels.latest_version_is_visible,Die letzte Version ist für den Kunden sichtbar,de_DE
quote_request_page.quote_request.labels.history,History,en_US
quote_request_page.quote_request.labels.history,Geschichte,de_DE
quote_request_page.quote_request.labels.customer,Customer,en_US
quote_request_page.quote_request.labels.customer,Kunde,de_DE
quote_request_page.quote_request.labels.company,Company,en_US
quote_request_page.quote_request.labels.company,Unternehmen,de_DE
quote_request_page.quote_request.labels.business_unit,Business unit,en_US
quote_request_page.quote_request.labels.business_unit,Geschäftseinheit,de_DE
quote_request_page.quote_request.labels.information,RfQ Information,en_US
quote_request_page.quote_request.labels.information,Informationen zur Angebotsanfrage,de_DE
quote_request_page.quote_request.labels.version_information,Version Information,en_US
quote_request_page.quote_request.labels.version_information,Versionsinformation,de_DE
quote_request_page.quote_request.actions.view,View,en_US
quote_request_page.quote_request.actions.view,Ansehen,de_DE
quote_request_page.quote_request.actions.cancel,Cancel,en_US
quote_request_page.quote_request.actions.cancel,Stornieren,de_DE
quote_request_page.quote_request.actions.save,Save,en_US
quote_request_page.quote_request.actions.save,Sparen,de_DE
quote_request_page.quote_request.actions.back_to_list,Back to List,en_US
quote_request_page.quote_request.actions.back_to_list,Zurück zur Liste,de_DE
quote_request_page.quote_request.actions.back_to_view,Back to View,en_US
quote_request_page.quote_request.actions.back_to_view,Zurück zur Ansicht,de_DE
quote_request_page.quote_request.actions.send_to_customer,Send to Customer,en_US
quote_request_page.quote_request.actions.send_to_customer,Senden Sie an den Kunden,de_DE
quote_request_page.quote_request.actions.send_to_agent,Send to Agent,en_US
quote_request_page.quote_request.actions.send_to_agent,An Agent senden,de_DE
quote_request_page.quote_request.actions.save_and_back_to_edit,Save and Back to Edit,en_US
quote_request_page.quote_request.actions.save_and_back_to_edit,Speichern und zurück zum Bearbeiten,de_DE
quote_request_page.quote_request.actions.convert_to_cart,Convert to Cart,en_US
quote_request_page.quote_request.actions.convert_to_cart,In den Warenkorb konvertieren,de_DE
quote_request_page.quote_request.actions.revise,Revise,en_US
quote_request_page.quote_request.actions.revise,Überarbeiten,de_DE
quote_request_page.quote_request.actions.edit,Edit,en_US
quote_request_page.quote_request.actions.edit,Ändern,de_DE
quote_request_page.quote_request.actions.edit_items,Edit Items,en_US
quote_request_page.quote_request.actions.edit_items,Elemente bearbeiten,de_DE
quote_request_page.quote_request.view.empty,You do not have any quote requests yet.,en_US
quote_request_page.quote_request.view.empty,Sie haben noch keine Angebotsanfragen.,de_DE
quote_request_page.quote_request.updated,Quote request updated successfully.,en_US
quote_request_page.quote_request.updated,Angebotsanfrage erfolgreich aktualisiert.,de_DE
quote_request_page.quote_request.sent_to_customer,Quote request sent to customer successfully.,en_US
quote_request_page.quote_request.sent_to_customer,Angebotsanfrage erfolgreich an den Kunden gesendet.,de_DE
quote_request_page.quote_request.sent_to_user,Request for quote was successfully sent to the agent for processing.,en_US
quote_request_page.quote_request.sent_to_user,Die Angebotsanfrage wurde erfolgreich zur Bearbeitung an den Agenten gesendet.,de_DE
quote_request_page.quote_request.use_default_price,Use default price,en_US
quote_request_page.quote_request.use_default_price,Standardpreis verwenden,de_DE
quote_request_page.quote_request.converted_to_cart,Quote request converted to cart successfully.,en_US
quote_request_page.quote_request.converted_to_cart,Die Angebotsanfrage wurde erfolgreich in den Warenkorb konvertiert.,de_DE
quote_request_page.quote_request.edit_items_confirm,"You are editing RfQ <a href=""%link%"">%reference%</a> if you will leave it, all changes will be dropped.",en_US
quote_request_page.quote_request.edit_items_confirm,"Sie bearbeiten RfQ <a href=""%link%"">%reference%</a> wenn Sie es verlassen, werden alle Änderungen verworfen.",de_DE
agent.account.quote_request,Requests for Quote,en_US
agent.account.quote_request,Angebotsanfragen,de_DE
quote_request_agent_widget.quote_request,Request for Quote,en_US
quote_request_agent_widget.quote_request,Angebotsanfrage,de_DE
quote_request_agent_widget.items,Items,en_US
quote_request_agent_widget.items,Artikel,de_DE
quote_request_agent_widget.no_request_created,You do not have any quote requests yet.,en_US
quote_request_agent_widget.no_request_created,Sie haben noch keine Angebotsanfragen.,de_DE
quote_request_agent_widget.create_new_request,Create new RfQ,en_US
quote_request_agent_widget.create_new_request,Neue Angebotsanfrage,de_DE
quote_request_agent_widget.view_all_requests,View all requests,en_US
quote_request_agent_widget.view_all_requests,Alle Anfragen anzeigen,de_DE
quote_request_agent_widget.form.select_customer,Select customer,en_US
quote_request_agent_widget.form.select_customer,"Wählen Sie den Kunden aus",de_DE

Run the following console command to import data:

console data:import glossary

Verification

Make sure that in the database the configured data are added to the `spy_glossary` table.

3) Set up Behavior

Set up Quote Request Workflow

Enable the following behaviors by registering the plugins:

Plugin	Specification	Prerequisites	Namespace
PurchaseOrderNumberMetadataFieldPlugin	Adds purchase order number to metadata for `QuoteRequest` form.	None	`SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage`
DeliveryDateMetadataFieldPlugin	Adds delivery date to metadata for `QuoteRequest` form.	None	`SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage`
NoteMetadataFieldPlugin	Adds note to metadata for `QuoteRequestAgent` form.	None	`SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage`
PurchaseOrderNumberMetadataFieldPlugin	Adds purchase order number to metadata for `QuoteRequestAgent` form.	None	`SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage`
DeliveryDateMetadataFieldPlugin	Adds delivery date to metadata for `QuoteRequestAgent` form.	None	`SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage`
NoteMetadataFieldPlugin	Adds note to metadata for `QuoteRequestAgent` form.	None	`SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage`

Pyz\Yves\QuoteRequestPage\QuoteRequestPageDependencyProvider.php

<?php
 
namespace Pyz\Yves\QuoteRequestPage;
 
use SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage\DeliveryDateMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage\NoteMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestPage\Plugin\QuoteRequestPage\PurchaseOrderNumberMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestPage\QuoteRequestPageDependencyProvider as SprykerQuoteRequestPageDependencyProvider;
 
class QuoteRequestPageDependencyProvider extends SprykerQuoteRequestPageDependencyProvider
{
    /**
     * @return \SprykerShop\Yves\QuoteRequestPageExtension\Dependency\Plugin\QuoteRequestFormMetadataFieldPluginInterface[]
     */
    protected function getQuoteRequestFormMetadataFieldPlugins(): array
    {
        return [
            new PurchaseOrderNumberMetadataFieldPlugin(),
            new DeliveryDateMetadataFieldPlugin(),
            new NoteMetadataFieldPlugin(),
        ];
    }
}

Verification

Verify that, as a customer, on quote request edit page, you can edit following fields:

Purchase Order Number
DeliveryDate
Note

Pyz\Yves\QuoteRequestAgentPage\QuoteRequestAgentPageDependencyProvider.php

<?php
 
namespace Pyz\Yves\QuoteRequestAgentPage;
 
use SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage\DeliveryDateMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage\NoteMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestAgentPage\Plugin\QuoteRequestAgentPage\PurchaseOrderNumberMetadataFieldPlugin;
use SprykerShop\Yves\QuoteRequestAgentPage\QuoteRequestAgentPageDependencyProvider as SprykerQuoteRequestAgentPageDependencyProvider;
 
class QuoteRequestAgentPageDependencyProvider extends SprykerQuoteRequestAgentPageDependencyProvider
{
    /**
     * @return \SprykerShop\Yves\QuoteRequestAgentPageExtension\Dependency\Plugin\QuoteRequestAgentFormMetadataFieldPluginInterface[]
     */
    protected function getQuoteRequestAgentFormMetadataFieldPlugins(): array
    {
        return [
            new PurchaseOrderNumberMetadataFieldPlugin(),
            new DeliveryDateMetadataFieldPlugin(),
            new NoteMetadataFieldPlugin(),
        ];
    }
}

Verification

Verify that, as an agent, on quote request edit page, you can edit following fields:

Purchase Order Number
DeliveryDate
Note

4) Enable Controllers

Controller Provider List

Name	Namespace
`QuoteRequestPageControllerProvider`	`SprykerShop\Yves\QuoteRequestPage\Plugin\Provider`
`QuoteRequestAgentPageControllerProvider`	`SprykerShop\Yves\QuoteRequestAgentPage\Plugin\Provider`
`QuoteRequestAgentWidgetControllerProvider`	`SprykerShop\Yves\QuoteRequestAgentWidget\Plugin\Provider`
`QuoteRequestWidgetControllerProvider`	`SprykerShop\Yves\QuoteRequestWidget\Plugin\Provider`

src/Pyz/Yves/ShopApplication/YvesBootstrap.php

<?php
 
namespace Pyz\Yves\ShopApplication;
 
use SprykerShop\Yves\QuoteRequestPage\Plugin\Provider\Responsive;
use SprykerShop\Yves\QuoteRequestAgentPage\Plugin\Provider\QuoteRequestAgentPageControllerProvider;
use SprykerShop\Yves\QuoteRequestAgentWidget\Plugin\Provider\QuoteRequestAgentWidgetControllerProvider;
use SprykerShop\Yves\QuoteRequestWidget\Plugin\Provider\QuoteRequestWidgetControllerProvider;
 
use SprykerShop\Yves\ShopApplication\YvesBootstrap as SprykerYvesBootstrap;
 
class YvesBootstrap extends SprykerYvesBootstrap
{
    /**
     * @param bool|null $isSsl
     *
     * @return \SprykerShop\Yves\ShopApplication\Plugin\Provider\AbstractYvesControllerProvider[]
     */
    protected function getControllerProviderStack($isSsl)
    {
        return [
            new QuoteRequestPageControllerProvider($isSsl),
            new QuoteRequestAgentPageControllerProvider($isSsl),
            new QuoteRequestAgentWidgetControllerProvider($isSsl),
            new QuoteRequestWidgetControllerProvider($isSsl),
        ];
    }
}

Verification

Verify `QuoteRequestPageControllerProvider`, log in as company user and open quote request list page by the link: `http://mysprykershop.com/en/quote-request`

Verification

Verify `QuoteRequestAgentPageControllerProvider`, log in as agent and open quote request list page by the link: `http://mysprykershop.com/agent/quote-request`

Verification

Verify `QuoteRequestAgentWidgetControllerProvider`, log in as agent, go to `http://mysprykershop.com/agent/quote-request/create` type three first letters from any company user email into the "Select customer" input and make sure that autocomplete works.

Verification

Verify `QuoteRequestWidgetControllerProvider`, log in as a company user, create quote request, go to Edit items page, ensure that you see the **Save** button in the right sidebar, click on it. Verify that changes that you've done for quote items saved.

5) Set up Widgets

Plugin	Description	Prerequisites	Namespace
`QuoteRequestMenuItemWidget`	Displays quote request list link in the customer menu.	None	`SprykerShop\Yves\QuoteRequestWidget\Widget`
`QuoteRequestCreateWidget`	Displays create quote request button on a cart page.	None	`SprykerShop\Yves\QuoteRequestWidget\Widget`
`QuoteRequestCartWidget`	Displays action buttons on cart page when editing quote request items.	None	`SprykerShop\Yves\QuoteRequestWidget\Widget`
`QuoteRequestCancelWidget`	Displays cancel button on a quote request list page.	None	`SprykerShop\Yves\QuoteRequestWidget\Widget`
`QuoteRequestAgentOverviewWidget`	Displays functionality for quote request manipulation for agent.	None	`SprykerShop\Yves\QuoteRequestAgentWidget\Widget`
`QuoteRequestAgentCancelWidget`	Displays cancel quote request button on agent quote request list page.	None	`SprykerShop\Yves\QuoteRequestAgentPage\Widget`

src/Pyz/Yves/ShopApplication/ShopApplicationDependencyProvider.php

<?php
 
namespace Pyz\Yves\ShopApplication;
 
use SprykerShop\Yves\QuoteRequestWidget\Widget\QuoteRequestMenuItemWidget;
use SprykerShop\Yves\QuoteRequestWidget\Widget\QuoteRequestCreateWidget;
use SprykerShop\Yves\QuoteRequestWidget\Widget\QuoteRequestCartWidget;
use SprykerShop\Yves\QuoteRequestWidget\Widget\QuoteRequestCancelWidget;
use SprykerShop\Yves\QuoteRequestAgentWidget\Widget\QuoteRequestAgentOverviewWidget;
use SprykerShop\Yves\QuoteRequestAgentPage\Widget\QuoteRequestAgentCancelWidget;
use SprykerShop\Yves\ShopApplication\ShopApplicationDependencyProvider as SprykerShopApplicationDependencyProvider;
 
class ShopApplicationDependencyProvider extends SprykerShopApplicationDependencyProvider
{
    /**
     * @return string[]
     */
    protected function getGlobalWidgets(): array
    {
        return [
            QuoteRequestMenuItemWidget::class,
            QuoteRequestCreateWidget::class,
            QuoteRequestCartWidget::class,
            QuoteRequestCancelWidget::class,
            QuoteRequestAgentOverviewWidget::class,
            QuoteRequestAgentCancelWidget::class,
        ];
    }
}

Run the following command to enable Javascript and CSS changes:

console frontend:yves:build

Verification

Make sure that the following widgets were registered:

Module	Test
`QuoteRequestMenuItemWidget`	Log in as a company user, go to My Account page, make sure that you see "Requests for Quote" link.
`QuoteRequestCreateWidget`	Log in as a company user, go to Quote page, make sure that you have some products in the cart. Make sure that you see Request For Quote button.
`QuoteRequestCartWidget`	After you've pressed the Edit Items button on request for a quote, make sure that you see "Save" and Send To Agent buttons on a cart page.
`QuoteRequestCancelWidget`	Make sure that you see the Cancel button on the quote request page.
`QuoteRequestAgentOverviewWidget`	When you logged in as an agent make sure that you see a list of quote requests.
`QuoteRequestAgentCancelWidget`	Make sure that when you logged in as an agent you can see the Cancel button for each quote request.

Was this article helpful?

Tell us what could be better

Name (Optional)

Email (Optional) Invalid email format.

Type your thoughts here

We appreciate the time you took to share the feedback
and will consider it as soon as possible.

Thank you!

For submitting the form