CoolCMS API

ProductSetPresenter extends BasePresenter

in package

• Application

uses AddToCartTrait, CategoryTrait, ProductSetListTrait, ProductSetDetailTrait

Product catalog presenter (`Front:Eshop:ProductSet`).

Table of Contents

Constants

DEFAULT_URL_PARAMS  : mixed = [ 'page' => null, 'view' => null, 'order' => nu...

URL state reset for a link that starts a new flow (e.g. "Add advert" from a list).

DEFUALT_URL_PARAMS  : mixed = self::DEFAULT_URL_PARAMS

IDENTITY_LOCALIZED_KEYS  : mixed = ['site.name', 'site.tagline']

Text identity keys that have language variants `<key>.<alias>`.

SESSION_NAMESPACE  : mixed = 'front'

DETAIL_INCLUDES  : mixed = [ 'translations', 'product.translations', 'prod...

FALLBACK_LAYOUT  : mixed = '@layout_one.latte'

Layout used when the theme lacks the requested one.

IDENTITY_ASSET_KEYS  : mixed = ['site.logo.assetId' => 'setLogo', 'site.logo.d...

Setting key to DTO setter; the order matches the form fields.

IDENTITY_MODULE  : mixed = 1

Identity settings live in the System module.

LIST_INCLUDES  : mixed = ['translations', 'productState', 'tags.translat...

`ratingThread`: the rating on the product card. The thread carries denormalized aggregates (`ratingCount`, `ratingAvg`), so it is one extra join, not a product query; without the include the card would touch a lazy association and the list would get N+1.

LOCALE_MAP  : mixed = ['cs' => 'cs_CZ', 'en' => 'en_US', 'sk' => 'sk_...

Maps the short language code to the full locale of the registered NEON sources.

SETTINGS_MODULE  : mixed = 4

Settings module (`cms_system_settings`): e-shop = 4.

Properties

$accessTokenValidator  : AccessTokenValidator

Validates access tokens beyond signature and expiry.

$accountDeletionSessionManager  : AccountDeletionSessionManager

Account deletion — cancel ticket of a sign-in refused while the account awaits deletion.

$authManager  : AuthManager

$authStorageManager  : AuthStorageManager

$categorySlugTranslator  : ProductCategoryNameTranslator

Router translator; the same one that builds the slug from the id in links (see init below).

$checkoutManager  : CheckoutManager

Customer orders; the detail reads only one thing from them: who bought this set ("verified purchase" on reviews and the right to write a review).

$container  : Container

$currencyContext  : CurrencyContext

$currencyManager  : CurrencyManager

$deviceDetector  : DeviceDetector

$displayPaymentRegionManager  : PaymentRegionManager

IMPORTANT: a custom name, not `$paymentRegionManager`. Several presenters (Discussion/Bazaar Payment) have the region manager in the constructor, and a same-named property would break the container ("Cannot redeclare").

$eventDispatcher  : EventDispatcher

$googleIntegrations  : GoogleIntegrations

Google services from the third-party connections, used in the page head (`analytics.latte` templates).

$identityAssetManager  : AssetManager

$jwtManager  : JwtManager

$languageContext  : LanguageContext

$languageManager  : LanguageManager

$localizationContext  : LocalizationContext

$localizationManager  : LocalizationManager

$loginDeviceCookie  : LoginDeviceCookie

"Known device" cookie for the password login throttle ({@see self::rememberLoginDevice()}).

$modalWindowsFactory  : ModalWindowsFactory

$pageManager  : PageManager

$presenterContext  : PresenterContext

$reCaptchaRuntime  : ReCaptchaRuntime

Decides at runtime whether forms use reCAPTCHA (configuration plus the connection set up in the admin).

$routerDispatcher  : RouterDispatcher

$securityConfig  : SecurityConfig

reCAPTCHA switch for templates (`$reCaptchaEnabled` in the `scripts.latte` templates).

$settingContext  : SettingContext

$settingManager  : SettingManager

$siteBaseUrl  : SiteBaseUrl

Website address for links outside the request; public because components use it (`MessageInfoLine`).

$slug  : string|int|null

$socialsShareFactory  : SocialsShareFactory

Detail sharing to social networks; the same component as the advert detail.

$themeContext  : ThemeContext

$themeManager  : ThemeManager

$themeResolver  : DefaultThemeResolver

$translator  : ITranslator

$translatorSessionResolver  : Session

$userManager  : UserManager

$debugMode  : bool

$metaData  : MetaDataDTO|null

$ogData  : OgDataDTO|null

$pageEntity  : Page|null

$productionMode  : bool

$siteIdentity  : SiteIdentityDto|null

$translatorDomain  : string

$cart  : CartManager

$currentCategory  : ProductCategory|null

$esSearcher  : EsSearcher

$isLoggingIn  : bool

$parameterManager  : ParameterManager

$productCategoryManager  : ProductCategoryManager

$productSet  : ProductSet|null

$productSetManager  : ProductSetManager

$ratingFactory  : RatingFactory

$theme  : Theme|null

$variants  : array<int, ProductSet>

Variants = other sets of the same product (`product_id`), including the displayed one.

$visibleAccessories  : array<int, object>

$visibleSetItems  : array<int, object>

Methods

__construct()  : mixed

actionDetail()  : void

actionList()  : void

beforeRender()  : void

Tells templates whether the e-shop is in "catalog only" mode (`4/catalog.only`); cart CTAs are not rendered at all then.

completeExternalLogin()  : bool

Completes an OAuth login (`LoginExternalComponent`) with the same storage as a password login.

createComponent()  : IComponent|null

createComponentRating()  : Rating

createComponentSocialsShare()  : SocialsShare

formatLayoutTemplateFiles()  : array<string|int, mixed>

Returns candidate layout files; Nette takes the first existing one.

getContainer()  : Container

getCurrentCategory()  : ProductCategory|null

getDefaultUrlParams()  : array<string, null>

getPageEntity()  : Page|null

getProductSet()  : ProductSet|null

Returns the loaded detail set; read by the breadcrumb component ({@see \App\UI\Front\Eshop\Components\BreadcrumbComponent\Breadcrumb}), like `getCurrentCategory()` on the list. It is `null` before `actionDetail()`.

getRouterDispatcher()  : RouterDispatcher

getTranslator()  : ITranslator

handleAddToCart()  : void

handleChangeLocale()  : void

handleLogout()  : void

handleSignOut()  : void

Sign-out from an ordinary link (account menu), also without JavaScript.

hasServiceByType()  : bool

Returns whether the container has a service of the given type.

initCurrentCategory()  : void

initializeTranslator()  : void

loadModalWindowComponent()  : void

loginWithCredentials()  : void

Logs in by username and password; called only by the login form (after validation and CSRF).

redirectToPendingAccountDeletion()  : void

Account deletion: a sign-in (password or OAuth) was refused because the account awaits deletion: keep the cancel ticket in the session and go to the "Account deletion" page, which offers "Cancel the deletion". Without a ticket (should not happen) the visitor gets the plain refusal flash instead.

renderDetail()  : void

renderList()  : void

setConfigParameters()  : void

setTranslator()  : $this

startup()  : void

typedComponent()  : T

Returns a subcomponent with a verified type.

buildSiteIdentity()  : SiteIdentityDto

checkAuthentication()  : void

createComponentFrontSystemModalWindows()  : ModalWindows

currentAbsoluteUrl()  : string

Returns `link('//this')`, or the request address without query when it cannot be built.

fallbackToMainLocalization()  : bool

Whether the presenter may fall back to the main localization for an unknown locale; a regular page may not (404).

getSessionKey()  : string

Returns a session key string, e.g. 'front.auth.step1'.

getSessionSection()  : SessionSection

Returns a Nette\SessionSection instance using a dynamically built session key.

initializeMetaData()  : void

initializeOgData()  : void

initializePresenterContext()  : void

initSiteIdentity()  : void

isSameSiteRequest()  : bool

Tells whether the request comes from the own site (Nette SameSite cookie); protects GET actions with a side effect.

loadPageEntity()  : Page|null

Returns the page of the request by `slug` (empty is the home page, a number is the ID, otherwise `href`).

logout()  : void

metaData()  : MetaDataDTO

Returns the page meta data; filled by startup, an empty DTO before that.

ogData()  : OgDataDTO

Returns the page OG data; filled by `initializeOgData()` in startup, an empty DTO before that.

prepareMetaData()  : MetaDataDTO

prepareOgData()  : OgDataDTO

setTranslatorDomain()  : void

buildDefaultOgImage()  : OgImageDTO|null

Builds the default OG image from the site identity (admin, settings, site identity).

createIdentity()  : SimpleIdentity|null

createMultiplierComponent()  : Multiplier<string|int, IComponent>

Creates a multiplier for the component.

createNewComponentInstance()  : IComponent|null

Creates a new component instance without adding it to the presenter; used by the multiplier.

createStandardComponent()  : IComponent|null

Creates a standard component (not a multiplier).

expireIdleLogin()  : bool

Checks whether the login expired from inactivity.

formatLayoutCandidates()  : array<int, string>

getClientIp()  : string

identitySetting()  : string

Returns the module 1 key value as a string (empty when the key is missing or not a scalar).

identitySettingOrNull()  : string|null

Works like {@see identitySetting()}, but an empty value is null (the template omits the field).

initializeDisplayRegion()  : void

Initializes the currency and VAT display of prices.

initializeExternalFiles()  : void

initializeMetaTags()  : void

initializePage()  : void

isCategoryBranchActive()  : bool

Whether the category and all its ancestors are active (nested set: an ancestor encloses lft/rgt).

isDevelopment()  : bool

isSetOrderable()  : bool

Returns whether the set may be ordered.

layoutFileExists()  : bool

loadIdentityAssets()  : array<int, Asset>

Loads the identity assets by id, keyed by id.

loadLocalization()  : Localization|null

Returns the localization by `loc` from the URL, or `null` when there is no such locale.

loadVariants()  : array<int, ProductSet>

Returns the other sets of the same product = variants switchable in the buy box.

localizationCurrencyKey()  : string|null

Front needs no currency key from the localization; the currency and the display region are filled by {@see CurrencyInitTrait::initializeDisplayRegion()}.

localizedIdentitySetting()  : string

Returns the language-dependent identity value: `<key>.<page language alias>`; an empty or missing value falls back to the base key (default language). An empty string means neither is set.

logoutNetteUser()  : void

prepareFilters()  : array<int, Filter>

prepareOrderBy()  : array<string, bool>

prepareSearchFilter()  : Filter

Applies the fulltext through Elasticsearch (id -> `SearchIdFilter`); visibility, pagination and publish window stay in DB phase 1 (`ProductSetEligibilityFilters` are always applied). With ES off, an outage (circuit breaker) or a short query it falls back transparently to MySQL `MATCH_AGAINST`, with identical behavior to the original. Same as Blog `ArticleListTrait` / Bazaar `ParameterTrait`.

prepareSearchFilters()  : array<int, Filter>

Builds the filters for the search endpoint = everything except fulltext (handled on the Api side): `ProductSetEligibilityFilters`, category and parameter filters.

processFailedLogin()  : void

processInvalidToken()  : void

processLogin()  : void

processLoginException()  : void

processMissingToken()  : void

processSuccessfulLogin()  : void

processValidToken()  : void

readLoginDeviceToken()  : string|null

Returns the raw known-device cookie for the Api login (the Api verifies its signature).

redirectAfterLoginAction()  : void

Ends a sign-in attempt. A classic (non-AJAX) successful sign-in lands on "My account" ({@see PageId::SYSTEM_USER_ACCOUNT}); a failed one on the home page. An AJAX sign-in stays on the current page and only redraws the flash messages.

refreshNetteIdentity()  : bool

Refreshes the token for the same logged-in user.

rememberLoginDevice()  : void

Issues or renews the "known device" cookie after a successful login (password or OAuth).

resolveFeeCurrentPrices()  : array<int, string>

Returns the currently valid price of each fee of the set, for display.

resolveLoginErrorMessage()  : string

Resolves the translated login error text.

revokeTokensOnLogout()  : void

Calls the Api logout (revokes the refresh family and deny-lists the access `jti`) for the tokens of the current session.

searchViaApi()  : ProductSet>, 1: int, 2: bool, 3: array>}|null

Searches through the Api endpoint `api/eshop/product-set/search`. Three states (only the search path is handled for the e-shop; facets stay unchanged):

setNetteUser()  : void

tryRefresh()  : bool

Tries an automatic refresh when the access token has expired.