Categories and parameters#
Two things that together decide what the posting form looks like.
Parameters#
A parameter is one form field. Create them under Inzerce → Parametry.
| Field | Purpose |
|---|---|
| Key | the unique designation; some are reserved |
| Input type | text, number, select, date, price, file, opening hours… |
| Type in search | the filter may use a different one than the form |
| Required | |
| Has options | for selects |
| Default value | |
| Group | how fields are grouped in the form |
| Active | a disabled parameter is not shown on the site — its values do not appear in the detail, in listings or in e-mails. Stored values stay and come back once you enable it |
| Default parameter | offered to all categories automatically |
| Max. number of characters | upper limit of the text; a counter appears at the field |
| Always regenerate | only for the coordinate parameters (latitude and longitude) — see Coordinates from the address |
Reserved keys#
The system relies on name, price, email and regionId. See the
module overview.
Select options#
Options are records subordinate to the parameter. They are created beneath it.
Deleting a parameter takes all its options with it
And with them the values in every advert that used them. Disable an unwanted parameter rather than deleting it.
Disable an unwanted option, do not delete it
A disabled option is no longer offered in the posting form or in the filter. An advert that already has it stored keeps it — when that advert is edited, the option is still offered so saving does not wipe the value.
Coordinates from the address#
The advert's location is computed from the address into the latitude and longitude parameters. What happens to a value that is already filled in is decided by Always regenerate on those parameters:
| Always regenerate | What happens when the advert is saved |
|---|---|
| on | the coordinates are recomputed from the address on every save |
| off | a filled-in value stays; only an empty one is computed |
On other parameters the flag does nothing.
Filtering#
Each parameter sets how it behaves in the filter — whether all ticked values must match, or any of them.
For colours and brands you want any
Somebody ticking blue and red wants to see both, not only adverts that are both at once.
Content filtering#
A parameter can police what people write into it — banning links or forbidden words. The list of forbidden words is one for the whole site (shared by classifieds, the company directory) and is checked by the language of the page the visitor submits the form on: Czech forbidden words on a Czech page, English ones on an English page.
Replacement for forbidden words and Replacement for inserted URL are silent, only the timing differs: either right on save (the database ends up with already-cleaned text), or only on display (the database keeps the raw text, and it is cleaned only on the detail page, in meta tags, and in the specification).
A plain replacement shows the user no error
Banned content is silently replaced with [URL] or [***]. If you want to check
whether the filter caught something, you have to check the result. If the form
should reject such text outright, tick Error on forbidden word or Error on
inserted URL on the parameter — the field then shows an error message.
Banning links in the description is worth it
Otherwise a classifieds board quickly fills with links to other websites.
Paid links get through only the "on render" filter
An advert with the Show links tariff shows addresses as clickable links — but only when the link filter runs on render. With the "on save" filter the address is already replaced in the database and the tariff cannot bring it back. See Tariffs and payments.
Text length#
Text fields and text areas can have a Max. number of characters (Content filter section).
The form then refuses a longer text and says at the field how many characters are allowed.
Inside the field a counter shows how many have been typed — for example 45 / 100. In a field
with the editor only the visible text counts; formatting (bold, lists) does not. An empty value
means no limit.
Default limits
The advert title has 100 characters, the text 10,000. A longer description is harder to read anyway.
Display rules#
A field can be shown only under certain conditions — engine size only for cars, say. Display rules and linked selects are what do it.
Categories#
Created under Inzerce → Kategorie. They form a tree and are moved by dragging.
| Field | Purpose |
|---|---|
| Name, URL, description | per language |
| Parent category | |
| Free | an advert in it is not paid for; in a paid category the extension is paid too — see Advert validity |
| Credits | the price in credits |
| Advert validity in days | how long it lasts |
| Admin only | an ordinary user cannot post into it — the posting form offers neither it nor anything below it |
| Preferred | highlighted in listings |
| Active | a disabled category disappears from the site — see Disabled category |
Disabled category#
Unticking Active hides the category together with its whole branch:
- it is not offered in the category menu, among subcategories or in the category choice in search,
- it is not in the sitemap,
- its address (and the address of a subcategory below it) returns a page-not-found,
- no advert can be posted into it or its subcategories — the form does not offer it and rejects a forged link with it.
Adverts filed in it are not deleted by this.
Prices#
The price is entered per combination of region + payment gateway. A separate price can be set for visitors who are not logged in.
| Price-list cell | What it means on the site |
|---|---|
| empty | there is no price — the category cannot be paid through that gateway (and region); on the payment page the item is greyed out with "nelze zakoupit" (not available for purchase) |
| 0 | a real price of 0 — the item can be selected and paid at zero |
| a negative number | the form does not save it and says "Cena nesmí být záporná." (The price must not be negative.) at the field |
Clearing a cell removes that price from the price list.
Ticking Free hides the price table but does not clear it
The prices are still saved. Untick the flag later and the original values appear — go through them.
Category parameters#
Either the default parameters are used, or you target your own at the category. Each one specifies whether it is required and whether it also appears in search.
Start with the default parameters
Custom targeting makes sense for categories that genuinely differ — cars need other fields than books. Elsewhere it is extra work.
Pushing down to subcategories#
Both prices and parameters offer an option that carries the setting into the whole subtree.
Pushing down overwrites ALL subcategories without asking
Individual subcategory settings disappear and cannot be brought back. On a large tree, check what sits underneath before you change anything.
Advert validity#
A category has its own number of days. If an advert sits in several, the longest applies. If none of them sets a value, the module settings are used.
On extension or renewal the new validity is counted from the current validity if it still lies in the future, otherwise from today — and the same number of days is added. The end-of-validity notice then comes again for the new validity.
In a paid category the advert is extended only by paying
For an advert in a category without Free, the Extend ad and Renew ad tabs show the advertiser an explanation and an Extend with payment or Renew with payment button leading to the category payment. The validity moves only after the payment. The site offers the payment while the advert can be extended (2 days before the end of validity) or once it has expired. You can still change the validity by hand in the administration.
The advert counter#
A category shows a number of adverts; a parent includes its subcategories. It is a stored figure that is recalculated periodically.
A brief mismatch after posting is normal
After an advert is posted the count settles at the next recalculation, not immediately.
Deleting a category#
A category can be deleted even when it contains adverts. Its whole subtree goes with it, together with saved searches (watchdogs) set up on the deleted categories.
Procedure: delete a category#
- Open Inzerce → Kategorie.
- Choose delete for the category (or select several categories and delete them in bulk).
- Read the confirmation question: "Really delete this category including all subcategories? Adverts listed only in the deleted categories will lose their categorisation."
- Confirm.
Adverts are not deleted. An advert that was also in another category stays there. An advert listed only in the deleted categories is left without a category.
The whole subtree goes with it
Every subcategory disappears alongside it and the adverts in them lose their categorisation. Disable an unused category instead.