DJ-Classifieds
Overview files

All packages can be downloaded at http://www.design-joomla.eu/downloads/download.html

A complete list of availabe install packages:

  • DJ-Classifieds component
  • DJ-Classifieds Menu module
  • DJ-Classifieds Items module
  • DJ-Classifieds Search module
  • 1.DJ-Classifieds Latest Ads module for admin
  • 1.DJ-Classifieds Search plugin

Notice

All modules are based on DJ-Classifieds component. It means that they don't work without it.
 
Installation

Install all the packages in the ordinary way, start by installing DJ-Classifieds component first.

Navigate Extensions > Install/Uninstall

 

install1

 

Choose the package and press Upload File & Install

 

install2

 

 
DJ-Classifieds component

The DJ-Classifieds component allows you to add text advertisements into thematic categories, assigning images and descriptions to them. You can also allow users to add their own advertisements at your website and optional there is possibility to charge users for it.

See the basic steps to configure DJ-Classifieds component:

 
Create a category

Navigate Components > DJClassifieds

You will see a page with empty list of categories:

 

categories

 

Short description:

  • Categories – a list of categories, creating a category helps you to keep order of advertisements
  • Ads – a list of categorized advertisements

 

Let's start with creating an example category.

Press Add at the top panel, then you will see a page:

 

category-detail

 

Short description:

  • Name – enter a name of category
  • Price – enter a price if you want to charge users for adding an advertisement into category
  • Parent Category – the first category leave as Main Category, the next one can be assigned as a subcategory (optional)
  • Autopublish – publish category yes/no/global settings
  • Description – fill a text area with description of category (optional)
  • Existing images – gives an information about existing image related to an individual category
  • Add icon – add icon to the category (optional)

 

See an example list of categories:

 

categories-list

 

If you want to make some changes in added category e.g. change an image or a description, you have to edit a respective category.

See an example of an edited category:

 

category-edit

 

Make your changes and press Save button.

 
Set parameters

Now we can pass on to create the first advertisement.

Before doing this, take a look at a parameters view, where you can set ads and categories configuration. Press Parameters at the top panel.

 

 

Then you will see a parameters page, let's start with Main parameters:

 

param-main

 

Short description:

  • Expiration (days) – enter a number of days, duration time the ad is active
  • Expiration notification email (days) – number of days left before sending e-mail notification, for 0 notifications are not sending
  • Promoted ads price – price for promoted ads
  • Enable promoted – enable promoted ads yes/no, promotion advertisements are displayed at the top of the list with blue background color
  • Access level – type of users able to add their advertisements registered/all users
  • Autopublish – global setting of auto publishing yes/no
  • Notification email – select if you want to be informed or not about new ads
  • E-mail address – enter an e-mail address where the notifications should be sent
  • PayPal account – enter your PayPal account e-mail address
  • Price Unit – enter a currency you want to be displayed

 

Let's take a look at View parameters:

 

param-view

 

Short description:

  • Ads per page – number of items displayed per page
  • Number of columns in blog view – enter a number of columns that will be displayed in blog view
  • MAX number of images in ad – enter a maximum number of images in ad
  • MAX image size (MB) – select a maximum image size (0 for no limit)
  • Char limit in intro description – enter a maximum number of characters in intro description
  • Display amount of ads in a category – display amount of ads in a category yes/no
  • Allow html tags in description – allow to use html tags in description yes/no
  • Go straight to the classified – click from table and blog view goes directly to the classified's title
  • Display tooltip with a description on image hover – display tooltip with a description on image hover yes/no
  • Display tooltip with a description on title hover – display tooltip with a description on title hover yes/no
  • Price field – display price field yes/no
  • Contact form – display contact form yes/no
  • Ask seller form – display 'ask seller' form in the single item view yes/no
  • Show details – display ad details in the single item view yes/no
  • Show footer – display link to design-joomla.eu addons yes/no

 

Let's take a look at Images parameters:

 

param-images

 

Short description:

  • Popup thumbnail width/height – dimensions of an image measured in pixels, it is a popup image which appears after clicking on thumbnail image
  • Small Thumbnail width/height – dimensions of an image measured in pixels, it is a small image which appears next to the advertisement in the list view
  • Blog Thumbnail width/height – dimensions of an image measured in pixels, it is an image which appears in blog view of advertisements
  • Thumbnail width/height – dimensions of an image measured in pixels, it is an image which appears in the detail view of advertisement, it is linked to its large image
  • Category Thumbnail width/height – dimensions of an image measured in pixels, it is an image which appears in category view of advertisements

 

Let's take a look at Security and Spam parameters:

 

param-spam

 

Short description:

  • Pause time between messages – limit of minutes after which user can once again ask the question to ad
  • Number of messages per hour – number of massages that can be sent per hour
  • Captcha – a protection system to ensure that the response is not generated by a computer, if you enable it, users will have to read and put two words before adding an advertisement

 

Make your changes and press Save button.

 
Create an ad

When you have your parameters configured, choose Ads on control panel and press Add to add new advertisement.

You will see a page:

 

ad-detail

 

Short description:

  • Name – enter a name of advertisement
  • Parent Category – choose a category where an advertisement belongs to
  • Exp date – expiration date of advertisement
  • Promotion first – enable promotion yes/no, promotion advertisements are displayed at the top of the list with blue background color
  • Published – publish yes/no
  • Intro text – fill a text area with a short description of an advertisement
  • Description – fill a text area with a full description of an advertisement
  • Contact – enter a contact number/address to the vendor
  • Price – enter a price of item
  • Existing images – gives an information about all existing images related to an individual advertisement
  • Upload image – add an image to an advertisement

 

See an example list of advertisements:

 

ad-list

 

If you want to make some changes in added advertisement e.g. change an image or a description, you have to edit a respective advertisement.

See an example of an edited advertisement:

 

ad-edit

 

Make your changes and press Save button.

 
Displaying Classifieds on website

Navigate to a menu where you want to create a link and select DJ-Classifieds from a menu item type.

 

menu-item

 

Using a component, there are four ways to show your categorized items.

  • Add item
  • Category blog
  • Category table
  • Single item
  • User Items
 
Add item

This menu item allows users to add their own advertisements. Below you can see how looks the form of adding advertisement by user.

 

add-item

 

As you can see, this form is similar to the form of adding advertisement in the administration panel.

 
Category blog

This view allows to show all advertisements or advertisements from a single category as blog content view. Remember to insert uniqe ID for displaying a single category.

 

param-cat


Check an ID at category list:

 

check-category

 

Look at the example view of category blog. Promotion advertisements are on the top of the list and have a blue background to be more visible.

 

category-blog

 
Category table

This view allows to show all advertisements or advertisements from a single category as table content view. Remember to insert uniqe ID for displaying a single category.

 

param-cat

 

Check an ID at category list:

 

check-category

 

Look at the example view of category table. Promotion advertisements are on the top of the list and have a blue background to be more visible.

 

category-table

 

Short description:

  • Title – a title of advertisement
  • Category – a category of advertisement
  • Description – a description of advertisement
  • Added – date of adding advertisement
  • Displayed – a number of displays of advertisement
 
Single item

This view allows to show a single item.

 

item-id

 

Check an ID on advertisments list:

 

item-id2

 

Look at the example view of single item:

 

single-item

 

If you press Ask Seller button, you will see a text form.

 

ask

 

Enter your question and press Send button to send your question to seller.

 
User items

This view allows users to see a list of their advertisements.

 

user-items

 

Short description:

  • Title – a title of advertisement
  • Intro description – an intro description of advertisement
  • Added – date of adding advertisement
  • Ad expires – date of expiring of advertisement
  • Status – status of advertisement Active/Non-active
  • Edit – press „>>” to edit an advertisement
  • Renew – press „>>” to renew an advertisement
  • Delete – delete an advertisment
 
DJ-Classifieds Menu module

This module display all categories as menu links.

 

menu-mod

 
DJ-Classifieds Item module

This module displays advertisements in a certain order – last/popular/random.

 

items-mod

 

Let's look at the parameters:

 

 

Short description:

  • Number of items – number of advertisements displayed in the module
  • Order – choose order to display - last/popular/random
  • Show icon/date/category/description – show - yes/no
  • Description linked – description linked to the advertisement - yes/no
  • Chars in description – number of chars in description
  • Enable cache – enable cache yes/no
 
DJ-Classifieds Search module

Search module for DJ-Classifieds component.

 

search-mod

 
DJ-Classifieds Latest Ads module for admin

This is module for administration panel.
It allows to display in back-end a list of recently added classifieds.

Navigate to Extensions > Module Manager and switch to view of modules for administator panel:

 

admin-nav

 

Choose the proper module from the list.
Let's take a look at parameters of that module.

 

admin-param

 

Enter a number of ads that you want to display in the module, check if the module is published, select position to display (e.g. cpanel) and press Save button.

Look at the example view of module.

 

admin-mod

 
DJ-Classifieds Search plugin

DJ-Classifieds Search plugin allows you to search inside classifieds content.

search-plg