CoolCMS API

AdvertForm extends ParameterForm

in package

• Application

uses LoadingTrait, FormFieldsTrait, BuildAdvertTrait, UploaderTrait, RegionSuggestHostTrait

Abstract component for a modular form built from parameters.

Table of Contents

Constants

ADVERT_PASSWORD_MIN_LENGTH  : mixed = 6

Minimum length of a custom edit password of an advert.

REGION_PREVIEW_KEYS  : array<string|int, mixed> = ['city', 'zip', 'country']

Parameters that the preview prefills after a selection (parameter key = item data key).

Properties

$container  : Container

$onError  : array<string|int, callable(Form, static): void>

Signature: function(Form $form, self $component): void

$onSuccess  : array<string|int, callable(Form, ArrayHash, static): void>

$onValidate  : array<string|int, callable(Form, ArrayHash, static): void>

Events for the consumer (presenter / parent control). `ParameterForm` only renders and validates; business logic (save, email, redirect) belongs to whoever instantiates the component.

$routerDispatcher  : RouterDispatcher

$translator  : ITranslator

$appContext  : AppContext

$componentParameters  : array<string, mixed>

$context  : ParameterFormContext

$currencyContext  : CurrencyContext|null

$deviceDetector  : DeviceDetector|null

$itemsByGroups  : array<int, array<int, ParameterFormItem>>

$languageContext  : LanguageContext|null

$localizationContext  : LocalizationContext|null

$parameterAndOptionList  : array<int, ParameterInterface>

$parameterGroupList  : array<int, ParameterGroupInterface>

$parameterItems  : array<int, ParameterFormItem>

$registry  : ParameterHandlerRegistry

$settingContext  : SettingContext

$themeContext  : ThemeContext|null

$translatorDomain  : string|null

Translation domain is set by the module subclass (`AdvertForm`, `AdvertFilterBox`, ...).

$advert  : Advert|null

$advertManager  : AdvertManager

$blacklistedWordManager  : BlacklistedWordManager

$categoryList  : array<string|int, Category>

$categoryParameterRelManager  : CategoryParameterRelManager

$currencyManager  : CurrencyManager

$fieldBuilder  : ParameterFieldBuilder|null

$parameterGroupManager  : ParameterGroupManager

$parameterManager  : ParameterManager

$parametersInitialized  : bool

$regionManager  : RegionManager

$regionSuggestFactory  : RegionSuggestFactory

$uploaderDropzoneFactory  : UploaderDropzoneFactory

$userManager  : UserManager

Methods

__call()  : mixed

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

__construct()  : mixed

buildAdvert()  : Advert

Builds the Advert entity from submitted values. Public: the consumer (or {@see \App\UI\Front\Comcat\Components\AdvertFormComponent\AdvertForm::processSubmit()}) uses it to get a fully prepared entity without persistence.

createComponent()  : IComponent|null

getActiveFilters()  : array<int, array{parameterId: int, parameter: string, label: string, remove: array|null}>

Returns active filters for the badges above the list (`.pactive`), one entry per cancelable value, so "Sony" and "Canon" are two badges, not one.

getAdvert()  : Advert|null

getAppContext()  : AppContext

getComponentParameter()  : mixed

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

getContainer()  : Container

getCurrencyContext()  : CurrencyContext|null

getGroupChosenCount()  : int

Returns how many options of a group are selected, shown as a badge on the collapsible heading (`.filter-box__chosen`) so a collapsed group still shows that it filters.

getLanguageContext()  : LanguageContext|null

getLocalizationContext()  : LocalizationContext|null

getRouterDispatcher()  : RouterDispatcher

getSettingContext()  : SettingContext

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

getThemeContext()  : ThemeContext|null

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

Overrides the parent {@see \App\UI\Front\Base\Components\ParameterFormComponent\ParameterForm::getUploaderControlMap()}: maps the first IMAGE_UPLOADER to the shared `imgUploader` and the first FILE_UPLOADER to `fileUploader`.

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

Ids of parameters that have a dropzone uploader. A child may override it for different behavior (for example no uploaders: an empty array).

hasServiceByType()  : bool

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

initializeAllContexts()  : void

injectDeviceDetector()  : void

onCreate()  : void

render()  : void

renderActiveFilters()  : void

Renders badges of active filters above the list, not inside the filter: otherwise canceling a filter would be reachable only by scrolling back up.

renderJs()  : void

setAdvert()  : self

setAppContext()  : $this

setCategoryList()  : self

setComponentParameter()  : void

Sets a component parameter.

setCurrencyContext()  : $this

setLanguageContext()  : $this

setLocalizationContext()  : $this

setSettingContext()  : $this

setThemeContext()  : $this

setup()  : void

setupAppContext()  : void

typedComponent()  : T

Returns a subcomponent with a verified type.

uploaderName()  : string

Name of the child uploader component for an upload parameter.

beforeRender()  : void

Hook: a child component may add its own template variables (for example the edited entity).

beforeSubmitButton()  : void

buildContext()  : void

buildRegistry()  : ParameterHandlerRegistry

Default registry covering all `ParameterType` constants. A child component may override it to add its own handlers (for example module-specific types).

createComponentFileUploader()  : UploaderDropzone

createComponentForm()  : Form

createComponentImgUploader()  : UploaderDropzone

createComponentRegionSuggest()  : Multiplier<string|int, RegionSuggest>

extractParameterValues()  : array<int, array<int, array{value: mixed, value2?: ?string}>>

Helper that extracts form values. Returns only persistable parameters, i.e. not file/image types.

findParameterByKey()  : ParameterInterface|null

frontPresenter()  : BasePresenter|null

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

getEntityValues()  : array<int, mixed>

getFieldBuilder()  : ParameterFieldBuilder

Lazy shared builder of parameter fields, initialized from the resolved engine state (items/groups/context/mode). Entity values are read at the first build (after `setAdvert()`/`setCategoryList()`), as with {@see \App\Core\Form\Parameters\Building\DefaultsTrait::applyDefaults()}.

getMode()  : string

Hook: mode that selects `getType` or `getSearchType` on a parameter.

getParameterTranslation()  : ParameterTextInterface|null

getSubmitLabel()  : string

Hook: translation key of the submit button caption.

getTranslator()  : ITranslator

hasResolvedType()  : bool

For a child component: tells whether the form contains a parameter of the given type (respecting the mode via `resolveType()`).

initParameters()  : void

isUploadParameter()  : bool

A classic `IMAGE` / `FILE` parameter has its own `<input type="file">` (via the handler); the dropzone uploader handles only the multi-upload `*_UPLOADER` variants.

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

loadParameters()  : array<string|int, ParameterFormItem>

parameterKey()  : string

Form control key of a parameter (`parameter_<id>`). Field building is done by the shared {@see \App\Core\Form\Parameters\ParameterFieldBuilder}, but the engine and its consumers (filter URL params, email/region denormalization) need the same key to look up submitted values.

processSubmit()  : void

resolveDefaultValue()  : string|null

resolveType()  : int|null

setTemplateFile()  : void

setTranslator()  : self

usesDefaultParameters()  : bool

Hook: when a child component returns true, only parameters with `getDefault()` = true (classic) or `getSearchDefault()` = true (search) are shown.

aggregateCategoryParameterRels()  : array<int, array{order: int, required: bool, groupId: ?int}>

Aggregates CategoryParameterRels across all categories into a map parameterId => ['order' => MIN, 'required' => OR, 'groupId' => first-wins].

applyParameterRels()  : void

Builds the object-graph collection `parameterRels` from the submitted rows. `parameter` is a light reference (`new Parameter()->setId($id)`) that `EntityHydrator::extract` serializes as `{"id":{"id":X}}` and the Api `hydrateForPersist` resolves as a managed entity.

buildCurrencyItems()  : array<int, string>

buildParameterAndOptionList()  : void

Returns ids of the parameters that this parameterId uses (directly or through options), for lookup from rules. Options have no per-category override, so they are read straight from the Parameter entity.

buildRegionItems()  : array<int, string>

Parameter SELECT_REGION: a plain `<select>`, not a Picker.

buildRegionPreviewFieldMap()  : array<string, string>

configureUploaders()  : void

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

findFirstParameterOfType()  : Parameter|null

gateAdvertColumns()  : void

Column gate of the contact e-mail parameter: it is written into the profile column `email` varchar(255) ({@see BuildAdvertTrait}). The parameter builder knows only the parameter type, so a longer value failed the whole save on the database with the generic "could not be saved" message instead of an error at the field.

getDefaultUserValues()  : array<int, mixed>

Pre-fills fields from the logged-in user for a new record (edit has its own values from the entity). Dynamic parameters have no "default from user" in the code list, so the mapping is hard-wired via `Parameter::getKey()`: a key is mapped only when the form really contains a parameter with that key (otherwise it is skipped).

getRegionLabel()  : string

indexById()  : array<int, T>

indexItemsByGroups()  : void

indexItemsById()  : array<int, ParameterFormItem>

initRegionPickerContext()  : void

Selection validator for {@see ParameterFormContext::$regionValidator}: the advert form accepts only an active municipality (tree leaf), so an old advert filed under a country forces choosing a municipality on edit.

loadAdvertValues()  : array<int, mixed>

Values of the edited record: parameterId => value | value[] | ['value', 'value2'].

parameterControl()  : BaseControl|null

Form control of the parameter with the given key, null when the category does not use it.

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

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

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

setExpirationDate()  : void