Managing Categories

Categories, as you probably now, are used to group classifieds into groups like Pets, Real Estate, Vehicles, etc.
You can create an infinite number of categories and each category can have an infinite number of subcategories, sub-subcategories, etc.

Categories are managed from Admin -> Categories (example).
They have the following properties:

  • Name: the name of the category. This is a localizable field, which means it can be translated to other languages.
    The country flag next to the field shows for which language is this name. Translating this field can be done by going to to Admin -> Languages -> [find your language] -> click 'translations'.
  • Slug: this will be the URL of the category. If you enter here 'vehicles' then the URL of the category will be http://yourSite123.com/vehicles
    Slugs need to be unique for the site - you can't have a slug that is already used by another category or classified.
    Also the slug cannot be changed after the category is created.
  • Title: by default the titles of the categories are configured in Admin -> SEO. Typically they may look something like this:
    Classifieds for [Name of the category] - YourSite123.com
    If you leave the Title field empty then it will be taken from the SEO page and will look like the above. And you can use this field if you want to change it to something else.
  • Description: this is some text describing the category that will be shown on the category page, below the title. You can also use HTML here, put links, etc.
    This will also be the meta description for the category.
  • Allow classifieds inside: if this is checked then users will be able to post classifieds into this category. The idea of this field is that you may want to disallow posting inside the top-level categories and only inside their subcategories.
  • Order: this is some number that determines in what order the categories will be listed.
    Lets say you have 3 main (top-level) categories: Vehicles, Pets, Real Estate - and you want to list them in this order.
    So you would put the lowest Order on Vehicles, a higher Order for Pets and highest Order on Real Estate. For example:
    - Order (Vehicles) = 0
    - Order (Pets) = 10
    - Order (Real Estate) = 20

Creating Child Categories

To create a child category - click edit on the parent category.
On that page you will first see the category properties (Name, Title, etc.) and below it you can find the Child Categories section.

Custom Fields

When a new classified is created (like on this page) it has some standard set of fields - like Title, Description, Price, etc. Those fields are present for all classifieds.
However you may want to define specific custom fields that will be available only for certain categories.

For example, you can have a Vehicles category with two subcategories: Cars and Trucks.
All vehicles can have similar properties like Age and Engine Type. So you can define these two as custom fields for the Vehicles category and they will be present for all of Vehicle's subcategories.
Additionaly you can define a set of fields only on the Cars category - like Air Conditioner, ABS checkboxes and so on.

Custom fields have the following properties:

  • Name: name of the custom field (like Age, Brand, etc.)
  • Type: this can be either Text, Integer, Checkbox or Dropdown.
  • Required: whether the field is mandatory or can be left empty.
  • Dropdown options: this field is only shown if you choose Type to be Dropdown.
    It will display a textbox where you can enter the available options for the dropdown. Each option should be on a new line.
  • Searchable: allow searching by this attribute on the category pages.
  • Show on browse: whether to show this field when browsing through classifieds (like on category pages). If checked the value will be displayed below the classified description.
    This can be useful for example on a Cars listing page where you want the classifieds to display not only the image and description, but also the Brand, Model, City, etc. So that users don't have to click on each classified to see if this car is in their city.
  • Suffix: this is a text that can be appended after the field. For example if you have an integer field Age, you can add a suffix - "years" so that users know that the age is measured in years.
  • Inline CSS: here you can add some CSS properties that will be applied to the field (as an inline style). It's useful if you want to make some field smaller - you can put something like width: 50px; here.
  • Active: whether this field is available or not. If you don't click this then the field will only be present in Admin panel (for future use) and won't be displayed on the main site.