CoolCMS API

AdvertRenderer extends BaseComponent

in package

• Application

uses MultipliableTrait, ToggleRedrawTrait, FavouriteTrait

Renders one advert in a list. Used via {multicontrol} from AdvertListRenderer (Multiplier, key = advertId), so each advert has its own isolated 'advert' snippet — an AJAX toggle (favourite) redraws only that item.

Table of Contents

Constants

DESC_LIMIT  : int = 150

How many visible characters of the description a highlighted snippet may have. Must match `|truncate:150` in Style_1..3, otherwise the list would "bloat" when searching.

Properties

$container  : Container

$routerDispatcher  : RouterDispatcher

$translator  : ITranslator

$appContext  : AppContext

$componentParameters  : array<string, mixed>

$currencyContext  : CurrencyContext|null

$deviceDetector  : DeviceDetector|null

$languageContext  : LanguageContext|null

$localizationContext  : LocalizationContext|null

$selectedStyle  : string|null

$settingContext  : SettingContext

$themeContext  : ThemeContext|null

$translatorDomain  : string|null

$advert  : Advert|null

$advertManager  : AdvertManager

$favouriteRedrawSnippets  : array<string|int, string>

Snippets / snippet areas redrawn after an AJAX toggle.

$favouriteSessionSection  : string

$headingTag  : string

$multiplierItemId  : string|int|null

$multiplierRenderMethod  : string|null

$multiplierUniqueKey  : string|null

$renderingDefault  : bool

Guard against the `renderDefault()` and `render()` delegation loop.

$session  : Session

Methods

__call()  : mixed

Dispatches `renderXyz()` to `render('Xyz', ...$args)`.

__construct()  : mixed

createComponent()  : IComponent|null

getAppContext()  : AppContext

getComponentParameter()  : mixed

Returns a component parameter, or null when it is not set.

getContainer()  : Container

getCurrencyContext()  : CurrencyContext|null

getFavouriteIds()  : array<string|int, int>

getLanguageContext()  : LanguageContext|null

getLocalizationContext()  : LocalizationContext|null

getMultiplierItemId()  : string|int|null

getMultiplierRenderMethod()  : string|null

Returns the render method of the multiplier.

getMultiplierUniqueKey()  : string|null

Returns the unique key of the multiplier.

getRouterDispatcher()  : RouterDispatcher

getSettingContext()  : SettingContext

getSettings()  : array<int, array<string, mixed>>

getThemeContext()  : ThemeContext|null

handleAddToFavourites()  : void

handleDelFromFavourites()  : void

hasServiceByType()  : bool

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

initFavourites()  : void

initializeAllContexts()  : void

injectDeviceDetector()  : void

isInFavourites()  : bool

isInMultiplier()  : bool

Returns whether the component is rendered inside a multiplier.

loadAdvert()  : Advert|null

Loads an advert by ID and caches it into $this->advert. Also called from the signal handlers (Favourite), where there is no multiplier context and render() would otherwise not resolve the advert.

onCreate()  : void

render()  : void

setAdvert()  : self

setAppContext()  : $this

setComponentParameter()  : void

Sets a component parameter.

setCurrencyContext()  : $this

setFavouriteRedrawSnippets()  : self

setHeadingTag()  : self

setLanguageContext()  : $this

setLocalizationContext()  : $this

setMultiplierContext()  : void

Sets the multiplier context; called automatically from `MultiControlMacros`.

setSettingContext()  : $this

setThemeContext()  : $this

setup()  : void

setupAppContext()  : void

typedComponent()  : T

Returns a subcomponent with a verified type.

frontPresenter()  : BasePresenter|null

Returns the front presenter the component is attached to (null outside the front end or when detached).

getTranslator()  : ITranslator

handleMultiplierSuccess()  : void

Handles a successful action in a multiplier (e.g. a form submit) and redraws the right snippet.

renderDefault()  : void

Aliases `render()` when no other render method is specified.

setTemplateFile()  : void

setTranslator()  : self

availableRenderStyles()  : array<int, string>

Returns styles derived from public `renderXxx()` methods, without `render()` and `renderDefault()`.

availableRenderStylesHint()  : string

Returns the message suffix listing styles; empty when the component has none.

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

finishToggle()  : void

Finishes a toggle signal: sets the style (so the default is not rendered after AJAX), redraws the given snippets of this component and flash messages.

firstRenderStyle()  : string|null

Returns the first available style, used as an example in the message.

getFavouriteSection()  : SessionSection

prepareTemplate()  : void

resolveAdvert()  : Advert|null

Advert resolution: 1) explicitly set, 2) already loaded in the parent AdvertListRenderer (no extra query), 3) loaded by the multiplier key (fallback for a standalone AJAX signal).

resolveHighlights()  : array<string, string>

Snippets for this profile: the data is held by the parent {@see AdvertListRenderer} and the item renderer picks them up through the multiplier. The parent has no standalone AJAX signal, so the result is empty (a redrawn profile without highlighting, no error).

resolveIsHighlighted()  : bool

Active paid "Highlighting" (card background through the class `highlighted`): the same path through the parent as {@see resolveHighlights()}; a standalone AJAX redraw without the parent falls back fail-open to `false`.

resolveStyleFromMultiplier()  : string|null

'style2' → 'Style_2'. After an AJAX signal the style comes primarily from $selectedStyle (passed by the signal); this is the multiplier-context fallback.