Using the Classifieds Application

The Ellington Classifieds application gives a marketing team access to managing and presenting classifieds listings to end users with a self service feature. The classifieds department will be able to set individual pricing for the various aspects of a listing such as, bold title, featured listing, extra images, etc. The end user will be given access at /classifieds/ to browse the listings that have been placed, and likewise create a listing and select the various properties and checkout with your desired payment gateway to place the listing on the site.

Classifieds Application

The Classifieds Application has several views which allow you to fully set and manage all aspects of the application itself as well as individual listings.



The Carts view is an area that is mostly for troubleshooting. This view allows you to see all the listings that were started, but never completed the checkout process. If a user is logged in, it will give you the username of that user, otherwise it will display a session id in the case that you don't require the user to login first.


Carts 1

Selecting any of the carts will give you the ability to see the user, their session id and the items that have been added to this cart's session. You will have the option to remove or change any item they have added to their cart, which effectively allows them to log back in to the site and finish checkout with those updated items.

Carts 2


Categories serve as you would expect, a classification system for the listings themselves. Just as in conventional classifieds systems, you might have garage sales, help wanted, automobiles, etc. These categories can be anything you want them to be and can be displayed on the frontend to allow users any easier way of finding the listings they are looking for.


Each category can have it's own SEF slug, description, and image that are all visible from the frontend, and you can likewise set sites they belong to, the order they appear on the page and their hierarchy as well.

Once categories are entered, they may appear on the frontend at /classifieds/ like so without any styling applied to them:


Classifieds Options

Classifieds options allow you to setup various "rules" for both print and online listings. They allow you to limit number of characters, images, and listing types for both print and online ads.


Discounts allows you to setup PROMO codes that can be ran to offer discounts to your users. They can be both a flat rate and a percentage of total sale.

When creating a discount code, simply press the Add Discount button, and then assign a CODE value. This can be anything you want. Give it a discount total next. If you want a dollar amount, enter the whole dollar amount with a decimal. If you want it to be a percentage enter the percentage amount with a "%" symbol. Set it's start and end dates, and voila, it's ready for you to market it.

Remember that the CODE value, is case sensative, so whatever is entered in this box, will need to be EXACTLY entered in the checkout process.


Listings are the bread and butter of the classifieds application.  Whether imported from an external system, entered by your staff, or self served from your users, the listings are what ultimately make up the Classifieds Application. The listings screen gives you an overview of the listings currently entered into the system. Listings will appear indefinitely, even if they are not active for historical reasons and transactional reasons.

Also worth noting, users on the frontend can login and see all of their old listings and choose to pay again for any old listings to re-list them.

Also included on this screen is the "print preview" function. This gives you a PDF version of the listing that can be downloaded and imported into InDesign or any layout tools that your team uses that support PDF.

Select a listing from the view and you will be presented with an opportunity to change/update/delete the listing. The options displayed will be all of the options the user had access to select on the frontend when the listing was created and you can change them here in the admin accordingly.

Changing the options here in the admin, will not constitute additional charges to the associated transaction, so removing or adding features to their listing is essentially done so free of charge/credit in the admin.

The title, approved state, price, display, category and description are the standard inputs required for a listing. The options below description are the available options to add additional pricing.

  • Title - the name of the listing that appears in the frontend views.
  • Approved State - Checked or not. By default all listings that have completed the checkout process are "approved", while those still in carts are not approved. This option can be changed by contacting your project manager.
  • Price - This is not the "cost" of the listing, but rather the price of the item being sold (if applicable) in the listing itself.
  • Display - Whether this is a print, online, or both listing
  • Category - The category this listing will appear under.
  • Description - The actual body of the listing.

For a more detailed breakdown of the options and their pricing see the prices section.  Each ad will be given a pub date, an expiration date and will be tied to a user if login is required for placing listings. In the case it is not required, a session id is also stored so you can easily tie a listing to a transaction.

The "Published" state is whether or not the listing will be published on the site. This is different than the "approved" listing since a listing can be both approved and unpublished due to various reasons.  (i.e. listing isn't set to go live yet, it's expired, the listing itself is okay, but  payment hasn't been received, etc.)

Some listings may be children listings underneath a single parent. In this case, select the parent from the dropdown. Typically this for imported listings only from older systems and otherwise don't require any input. Same goes for Original Ad Number. If you are bringing these listings in from a legacy system, you may want to reference a particular ID here.

The first tab will list the first image which is also the print image, while the subsequent images can be found on the second tab.


Prices are where we define the individual up-sell values of each possible component of a listing. These would be the "extra" features in a listing that may help a listing become more prominent on a page. Set a value for each option you wish to display on the frontend. These values should be whole dollar amounts and will be added up and displayed to the end user during the checkout process.

  • Default online price: The base price of an online listing.
  • Default print price: The base price of a print listing.
  • Default online and print price: The base price of the online/print listing.
  • Highlighted title: Cost of highlighting the title in both print and online.
  • Reverse Title (Print Only): Cost of a reverse title in print only.
  • Bold title: Cost of a bold title for an online listing.
  • Bold title print: Cost of a bold title for a print listing.
  • Feature listing: Cost of "featuring" the listing in the page slider online.
  • Cost per aditional day: Cost of running the listing longer than the default # of days online.
  • Cost per aditional day print:  Cost of running the listing longer than the default # of days in print.
  • Cost per aditional character: Cost of each character beyond the maximum set in the Classifieds Options for online listings
  • Cost per aditional character print: Cost of each character beyond the maximum set in the Classifieds Options for print listings.
  • Cost per aditional image: Cost of additional images for online only.
  • Cost of print image: Cost for having an image for print.
  • Cost for listing border: Cost for having a border on the listing online
  • Cost for listing border: Cost for having a border in the print listing.
  • Cost for colored background: Cost for having a colored background in online listing.
  • Cost for colored background: Cost for having a colored background in print listing.
  • Cost for displaying ads at the top: Cost for having the ad sticky to the top of the category listing page both print and online.
  • Cost for displaying hyperlinks: Cost of allowing hyperlinks in the online listing.

Transaction Items

Transaction Items lists the actual listings that have completed the checkout process. This view is mainly for reporting and troubleshooting purposes with customer support. This will be ads that are approved and unapproved as well as published and unpublished and is simply a transactional log of everything that has completed the checkout process.

Transaction Items

Inside each item you will see the exact transaction time and date, what listing it was applied to, the discounts (if any) and the total amount charged.


The transactions view exists in the case that you are only interested in an overall transaction and not in the individual items within that transaction. Worth noting, a transaction can contain multiple transaction items. A user can feasibly create 3 listings and checkout with 1 transaction, which would give them three transaction items within a single transaction.

Selecting any of the transactions will give you a full breakdown of the items within that transaction, the full response received from the payment processor (in case of troubleshooting why transactions are declined) as well as the amounts and customer information.


Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.