CoolCMS API

ArticlePresenter extends BasePresenter

in package

• Application

uses ArticleInitTrait, ArticleListTrait, ArticleDetailTrait, PermissionTrait, CategoryTrait, RegionTrait

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'

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', 'asset.translations', 'categor...

Includes of the list, the same for the plain DB path and the search endpoint.

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.

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  : CategoryNameTranslator

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

$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).

$id  : int

$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

$name  : string|null

$pageManager  : PageManager

$presenterContext  : PresenterContext

$reCaptchaRuntime  : ReCaptchaRuntime

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

$regionSlugTranslator  : RegionNameTranslator

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

$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

$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

$article  : Article|null

$articleManager  : ArticleManager

$categoryManager  : CategoryManager

$currentCategory  : Category|null

$currentRegion  : Region|null

$esSearcher  : EsSearcher

$hasPaidAccess  : bool

$isLoggingIn  : bool

$ratingFactory  : RatingFactory

$regionManager  : RegionManager

$theme  : Theme|null

$userPaymentManager  : UserPaymentManager

Methods

__construct()  : mixed

actionDetail()  : void

actionList()  : void

beforeRender()  : void

checkAccessPermission()  : bool

completeExternalLogin()  : bool

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

createComponent()  : IComponent|null

createComponentFrontBlogArticleRating()  : Rating

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

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

getArticle()  : Article|null

getContainer()  : Container

getCurrentCategory()  : Category|null

getCurrentRegion()  : Region|null

getDefaultUrlParams()  : array<string, null>

getPageEntity()  : Page|null

getRouterDispatcher()  : RouterDispatcher

getTranslator()  : ITranslator

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

initCurrentRegion()  : 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

renderPermissionDenied()  : 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).

checkUserPaymentValidity()  : bool

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

isRegionBranchActive()  : bool

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

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.

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

prepareCanonicalUrl()  : void

prepareCategoryFilter()  : void

prepareFilters()  : array<int, Filter>

Filters of the plain DB path: visibility plus full-text. The search endpoint uses only the visibility part; full-text is handled on the Api side (ES, fallback `MATCH_AGAINST`).

prepareOrderBy()  : array<string, bool>

prepareRegionFilter()  : void

prepareSearchFilter()  : Filter

Full-text of the plain DB path (fallback): ES ids go to `SearchIdFilter` (visibility, pagination and totalCount stay in the DB phase 1); with ES off or down (circuit breaker) a transparent fallback to MySQL `MATCH_AGAINST`, behaving as before.

prepareView()  : void

prepareVisibilityFilters()  : array<int, Filter>

Eligibility of an article in the list (activation, publication, category, paid access).

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).

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()  : Article>, 1: int, 2: bool, 3: array>}|null

Searches through the Api endpoint `api/blog/article/search` instead of building the filter in the presenter. Three states:

setNetteUser()  : void

tryRefresh()  : bool

Tries an automatic refresh when the access token has expired.