CraigsList Listing Tool


Installation & Configuration Part 1 Video

Installation is so simple it does not deserve its own video, so we have also included Configuration Part 1 with it.

Simply copy the entire “clt” folder to the root of your server.

http://www.domain-name.com/clt/index.php

Depending on your server configurations you may need to temporarily give the CLT folder full write permissions (chmod 777) to install. After installation, you can return the permissions to 755.

Again, depending on your server configuration, you may need to give the uploads directory (clt/uploads) full write permissions (chmod 777)

It is advised that you secure this folder with .htaccess. A user name and password is required to access the CLT, but allowing the general public to use this script will use up your diskspace, bandwidth, and give access to personal information! There is only one level of User Access Control; meaning, everyone with your user name and password will have full access to EVERYTHING in CLT (creating, editing, and deleting listings, deleting images, etc.)

Create a database with your host. Ask your host for assistance if you are not sure how to do this. Once you have a database, you will need to know the database host (usually “localhost”) the database name, the user name and the password. Once you have these 4 things, load up CLT http://www.domain-name.com/clt/index.php

It will automatically redirect you to the install page. (http://www.domain-name.com/clt/install.php) where you will be prompt for the four things previously requested.

Database Setup :

The first field is for the database server (usually “localhost” (no quotes)). Enter the name of the database, your user name and the password.

Admin Setup :

Give yourself a user name and password.

Click Save

The CraigsList Listing Tool will automatically install all the stuff needed for the database. It will also automatically log you in as well.



Installation & Configuration Part 1 Video
Same as previous video

After you click Save from the previous step, you will be brought to a Configurator page (http://www.domain-name.com/clt/config.php)

These settings are all optional. You do not have to change anything. You can zip down to the bottom of the page and hit ‘Save’ and be on your way, though, we strongly recommend you go through each setting.

Configuration (18 Fields)

Paths

These should already be filled in, just make sure they are correct!

This Domain : Should be the domain name of where CraigsList Listing Tool is located. (default example : http://www.domain-name.com)

This Directory : Should be the name of the directory CraigsList Listing Tool is located in (default example : clt)

This Directory : The name of the directory CraigsList Listing Tool will use to hold uploads (default example : uploads/)

Show Or Hide Stuff

WYSIWYG Editor : You can use a WYSIWYG editor or not. (default : Show).

Menu Location : You can select a location for the CLT Menu. Small resolution screens (1024px x whatever) should only use the bottom position! If you are unsure, either leave at the default Bottom, or you can select Both. If you select Both and don’t see the menu on the left, well, you know your screen is to small. It makes no difference, as long as you have access to one of the locations.(default : Bottom)

Show Warnings * : A box will be displayed to let you know if any of your listings will expire* a week before CraigsList 45 day expiration. (default : By Modified Date)

Show Expiration * : A box will be displayed to let you know if any of your listings have expired* CraigsList 45 day expiration. (default : By Modified Date)

* The CLT saves the date you created the listing, as well as the last time you modified it.

There are 4 options for these to settings.

Off : Um, well, it turns the messages off. It will not show you listing that are about to expire or that have expired.

By Creation Date : Will use the original creation date to let you know a if a listing is about to expire or has expired

By Modified Date : Will use the modification (updated) date to let you know a if a listing is about to expire or has expired

By Both Dates : Is double annoying. It will use BOTH the original creation date as well as the last modification date to let you know a if a listing is about to expire or has expired

Show or Hide Themes / Links / Menu / Buttons :

This will show/hide both the sections as well as the menu buttons.

Real Estate : If you do not sell houses or land, simply hide this. (default : Show)

Automotive : If you do not sell automobiles, simply hide this. (default : Show)

General : If you do not sell “stuff”, simply hide this. (default : Show).

Profile : If you do not want your profile on CraigsList, simply hide this. (default : Show)

Config : If you do not want the config button in the menu, simply hide this. (default : Show)

Stats : If you do not want the stats button in the menu, simply hide this. (default : Show)

CraigsList : If you do not want the CraigsList button in the menu, simply hide this. (default : Show)

Time Correction

If your servers time and your local time do not match, you can adjust it here.

Server Time : This is the current time on the server. (default : N/A).

OffSet : How many hours should be apply (plus or minus) to make the servers time match your local time? You will have to save before the changes take effect.(default : 0)

Corrected Time : This is the current time on the server (plus or minus) your corrections. Should match your local time after you hit save.(default : N/A)

Logo

You can upload your company logo (optional) if you would like it displayed in your CraigsList listing.

Logo : Upload your logo. For best results your logo should be 960px x 100px. For ultra best results, put a corner radius of 13px on it! logo.psd is included in the download. (default : N/A)

Preview : After you hit save, you will see a scaled version of your logo. (default : N/A)

If you do not have a logo or do not want to use your logo, just skip this section. The listing will not be affected by the lack of a logo!

Backlink

Allow us to place a miniscule link at the bottom of your CraigsList ad and you make the referral bonus!!

Show Back Link : Show a very tiny link at the bottom of your CraigsList ad. (default : Show)

Envato User Name : If you have an Envato account, put your user name here to make some cash. We will attach your Envato username to the referral link so you get the bonus. If you do not have an Envato account, or would like to be rather generous and help with the continued development of CLT and future CodeCanyon scripts by CodeFusion, simply leave our user name in the filed. (default : CodeFusion)

We want you to make an educated decision instead of just flipping this to off.

Here is how this works:

The backlink is a link to The CraigsList Listing Tool on CodeCanyon with your Envato user name as the referrer. By allowing us to show the very tiny backlink at the very very bottom of your listing. You will collect the referral bonus (30% of a new members first purchase/deposit) while helping us expose our CraigsList Listing Tool to the masses. A very win/win situation. Think about it, you are placing the listing in a CraigsList where hundreds, or thousands, or even hundreds of thousands of people may see it. If they click the link and buy a copy of your tool, you get the referral bonus and we get another sale!!

If you are not interested in the referral bonus, and/or you would like to give us extra help with further development of the CraigsList Listing Tool and other marvelous tools by CodeFusion, please keep the backlink active and leave CodeFusion as the Envato User name/Referrer. We’ll be grateful and you’ll see more features and tools from CodeFusion. Refer new users to any of the Envato Marketplaces and you’ll receive 30% of their first purchase or cash deposit!

Default Information (11 Fields)


Configuration Part 2 Video

Website Information

Website : If you have a company website, put it here. (default : N/A)

About Us : If you have a company website that has an “About Us” page, put it here. (default : N/A)

Contact Us : If you have a company website that has a “Contact Us” page, put it here. The CLT also comes with a contact page http://www.domain-name.com/clt/contact.php (default : http://www.domain-name.com/clt/contact.php)

If you do not have a website, leave these fields blank (except for the contact us (leave at default)) and we will filter this out of the listing so that there is no dead space.

Default Company Information

These fields are all optional. Filling them in here will pre-populate these fields when creating your ad. You will have the opportunity to change these defaults on every listing you create.

Company Name : Pre-populates applicable fields with your company name. (default : empty)

Company Phone : Pre-populates applicable fields with your phone number. (default : empty)

Company E-mail : Pre-populates applicable fields with your e-mail address – also used for the contact form. (default : empty)

Company Address : Pre-populates applicable fields with your physical address – also used for maps. (default : empty)

Company City : Pre-populates applicable fields with your city name – also used for maps. (default : empty)

Company State : Pre-populates applicable fields with your state name – also used for maps. (default : empty)

Company Zip : Pre-populates applicable fields with your zip code – also used for maps. (default : empty)

Company County : Only used for links to Google/Yahoo maps. (default : empty)

Default Template Colors (4 Fields)

These can all be changed on every listing. Setting these, just sets a default – say – to match company colors…

Background Color : Sets the default color for the background. (default : Default ( #87cefa ) )

Foreground Color : Sets the default color for the foreground. (default : Default ( #fafafa ) )

Font Color : Sets the default color for the font. (default : Default ( #666666 ) )

Highlight Color : Sets the default color for the highlights, headings, bullet lists, etc. (default : Default ( #dc143c ) )

Default Fancy Title (1 Fields)

This can all be changed on every listing. Setting this helps keep a “brand”. Don’t forget to click S’more Symbols for even more options*.

Title : Use the same set of symbols on every listing will help identify you amongst every other CraigsLister. (default : empty)

Using symbols in your title will reduce the length of your title. CraigsList has an input limit of 71 characters.

The symbols above the title field : Each symbol counts as (about) 7 characters each.

Symbols “under” the S’more Symbols link count as (about) 9 characters each

Example

The use of a Star (★) counts as 7 characters because even thought you visually see one “character” it actually takes 7 characters to create it (★)

Suggested use : ★ 57 Characters Left For Title Here ★           [7 + 35 + 7 = 49] [49 <= 71]

NOT Suggested use : ★★★★★Look★★★★★           [7*10+4 = 74] [74 !<= 71]

The Symbols above the title field are are cross browser compliant. Some symbols in the popup window are not cross browser compatible.

 

In order to preview the Imager Popup, you must save this Configurator page, then you can click the “Preview The PopUp” link.

Popup : Show or hides the “popup” (call to action) when using the Imager (default : Active)

Popup Title : The heading of the secondary popup window (default : “Thank You”)

Contact Link : A link to your company contact page, else leave blank to use the default contact form. (default : empty)

If you use the default contact form that is built into the CLT, when a user uses it, it will automagically grab the MLS/Vin/Title of the listing they are looking at when they pushed the ‘Contact Us’ button!

Popup Body : The body of the secondary popup box. It already includes a built in Contact button. (default : “<h2>We appreciate you taking an interest in our listing. If you have any questions what so ever, please don’t hesitate to contact us!</h2>”)



How To Create A Listing


Advanced Usage

Create New Listing

Usage is pretty strait forward as well. You do not need to know how to code anything to make the most of the CraigsList Listing Tool! Go to the main CLT page (http://www.domain-name.com/clt/index.php)

Lets Sell Something – This walkthrough is based on the Real Estate section – though it applies to Automotive and General as well.

Click the picture of the house in the upper left hand corner of the main CLT page. Seems how this is your first listing, there is nothing to select from the database, so lets move on to the next box.

If you filled in the default fields in the Configurator page, some fields may already be pre-populated with your information. Make sure these fields are correct!

Fancy Title

Title : Copy and paste your favorite symbol (or two) into the title field and give your listing a title. Don’t forget that there is a 71 character limit imposed by CraigsList (example : ✔ ★ Something Awesome For Sale ★ ✔)

Specifications

Price : Enter the price of the house. Format it the way you want. (example : $123,456)

MLS : If your property for sale is in an MLS, put its number here. This is for internal reference, as well as an easy way to identify the exact property. If you do not have an MLS number, make one up – like a serial number. (example : abc123def456)

Year : What year was the property built? (example : 2010)

Address : What is the address of the property for sale? This should be a physical address as we use it for Google/Yahoo maps. For obvious reasons, P.O. Boxes are useless here. (example : 123 Street St.)

City : What Metropolis/City/Town/Village does the property reside in? (example : Townsville)

State : What State/Province does the property reside in? (example : Nebraska)

County : What County does the property reside in? – this is only used for the Google/Yahoo maps. (example : Countyville)

Sq. Ft. : What is the total square footage of the property? (example : 10,000 sq. ft.)

Lot Size : What is the total lot size that the property resides on? (example : 15,000 sq. ft. or ¾ acre)

Bed : How many bedrooms does the property have? (example : 8)

Bath : How many bathrooms does the property have? (example : 12)

Garage : How many cars can fit in the garage? (example : 4)

Phone : What is YOUR phone number? (example : (555) 555-5555)

Website : Where is YOUR website? (example : http://www.domain-name.com)

About Us : Where is YOUR websites About Us Page? (example : http://www.domain-name.com/about_us.php)

Contact Us : Where is YOUR websites Contact Us Page? (example : http://www.domain-name.com/contact_us.php)

Property Features

3 Boxes : Each box will be turned into a bullet list. One feature per line! For best results, try to put an equal number of features in each box

Description

Description Box : If you have WYSIWYG enabled, you can enter your description in the box, highlight any text you want and click one of the formatting buttons (like ‘B’ for bold) to apply the effect.

Important Notes

CraigsList is very restrictive on what colors can be used for background (highlighting) and what can be used for font colors.

NOT all colors can be used. If you pick colors that CraigsList does not accept, they will be reverted to CraigsList default. (white background / black font)

A Note For Developers : You can add/edit/remove “Styles” by editing the config.js file found at clt/ckeditor/config.js Just follow the examples already in the file to create your own styles.

Images

All images will be shrunk down to 900px wide.

Large Images

If you try to upload a dozen images each at 3 megs, it will likely time out. You should presize your images (with Photshop/MS Paint) to be at a max width of 900px. The CLT will resize the images again as needed, but by presizeing them it will make the upload much quicker!

If you do not have Photoshop or MS Paint, we have provided an alternative solution. In the images section there is a link to a popup page where you can use CLT to resize your images before you upload them to the listing.

Don’t know how to resize your photos with Photoshop or MS Paint? Check out our resizing video

Primary : This image will be the large image used in the listing. It will also be a link to the CLT Imager page.

Image 01 – 12 : These images will be scaled and also used as links. If you are trying to upload HUGE images, it will take a while to process when clicking the preview button! Images are automatically shrunk to 600px wide. If you know how to shrink images with photoshop or MS Paint you can save some processing time by pre-shrinking the images to 600px wide.

Preview : After you save your listing to the database, an actual preview of the image will be displayed here. Hovering over the tiny preview will show you an enlarged view.

FireFox Bonus! : If you are using the FireFox Web Browser as soon as you select an image from your computer it will instantly show you a preview of that image.

Imager Links
When someone click a picture, it will open up a new window and display the imager page on the CLT. If enabled, it will initiate a lightbox slideshow, followed by the secondary lightbox with your call to action.

Template

Only colors that work on CraigsList are shown. CraigsList will allow some colors to be used as background colors but not font colors. We have painstakingly verified all these colors to make sure they work!

Background Color : This will set the overall background color for the CraigsList listing.

Foreground Color : This will set the overall foreground color for the CraigsList listing. For best results, leave at the default.

Font Color : This will set the overall font color for the CraigsList listing.

Highlight Color : This will set the overall highlight color for the CraigsList listing. This affects the list bullets, headings, and links

Template : Find a template that looks good with your listing. All the template pictures are with the profile added.

Profile : If you have setup a profile, you can optionally attach it to this listing.

Preview

Click the Preview Button : This will open a new window/tab and show you what your CraigsList listing will look like. It is also where you will be able to save the listing to the database.

Preview

This page is divided into two parts. The first part is how the listing will look once posted on CraigsList.

First Part – Things to look for

Logo : If you uploaded your logo in the Configurator, make sure it looks good here!

Colors : Make sure your colors look good together.

Error Check : Make sure there are no errors or misrepresentations.

Features : Make sure your features are staying within their bounds and not running amuck! It they don’t look good, revise the features or select a different template.

Imager Links : If you click a picture before you save the listing to the database, the imager will error!

Save : If you are happy with the way the listing looks SAVE IT! This is the only way to get the code you need to post your listing.

Second Part – What to do

Title : Under the save button you will see a preview of your title – as it will appear on CraigsList. In order to make that happen, you need to select all the text in the box below the title preview and copy that text to the CraigsList “Post Title”.

Box Full of “stuff” : This “stuff” is all the code that is needed to make your CraigsList listing look like the top half of the page. It has been ‘Minified’ for copy and paste ease. Copy EVERYTHING in the big box to the CraigsList “Post Description”

Show Non-Condensed : This shows the exact same code without the minification. This is for advanced users who want to add more code to their listing. Most people should just ignore this!


Updating / Modifying Database

Select Listing : If you want to update a listing that is already in the database – select it from the drop down and click the select button.

Deleting Listing : Once you have selected the listing a delete button with a check box on both sides will appear. You must check BOTH boxes and then click delete in order to delete that listing. When you delete a listing, it will also delete the images associated with that listing from the uploads folder as well!

Images : In the Images section, under the upload box will be the name of the current image. Hover over that link to show a large preview of that image, else over over the preview to show a large version of that preview.

Delete Image : Deleting an image is a 4 step process! This is because if you delete an image, the image will also be deleted from any listings on CraigsList!

Step One : Under the upload box you will see the name of the current image. To the right of that is a check box. Place a check in the box to remove that particular image.

Step Two : Click the Preview Button at the bottom of the page.

Step Three : Preview Page. The preview shows you how it will look with the image removed. The image has not been deleted, just hidden. Just above the “Save” button in red text will be a check box. Place a check in that box to delete the image.

Step Four : Click Save.

Now the image has been deleted from the server and the database has been updated to remove the image as well.
The image has also been removed from any listings on CraigsList that used that image!


Viewing Stats (Hit Counts)


Creating A Profile

Hit Counter

CraigsList Hit Counter : Every time someone looks at your CraigsList listing on CraigsList, it will increase the hit count by 1.

Imager Hit Counter : When someone looks at your CraigsList listing on CraigsList AND clicks an image (for a better view), it will load the CLT Imager page which has it own hit counter for each listing.

Why Two Hit Counters : Well, when a search bot loads the listing on CraigsList it will count as a hit and every person that looks at your listing will count as a hit. This number can go quickly.

We have added a “No Follow” clause to the imager links so that search bots should not follow these links.
Therefore, you will get a more realistic hit count on the imager page.

Think of it like this: If CraigsList Hit count = 100 and Imager Hit Count = “75”

This would be interpreted as 100 people seen your ad, and 75 of them where interested enough to click a picture for a better view.

So what do these numbers mean?

Well if CraigsList hits are 100, and the imager hits are 75, you can assume your listing is enticing people to want a better view the the listing. This is a good thing.

But if CraigsList hits are 100, and the imager hits are 10, you can assume your listing is lacking and people are not interested enough to want more information. This is bad! Try to spice up your listing. However, it may be that your listing is just fine, but the property itself is not exciting or in demand.

CKFinder

Attention : CKFinder is NOT included in the download as it requires you to purchase a license to use it. However, for those of you who do purchase a license, we have included a CKFinder “hook” to help with integration! We cannot provide in-depth support for CKFinder, but as you see in our demo, it does work.

Installation : When you download CKFinder open the zip file. You will see one folder called “ckfinder” copy just the contents of that folder into the ckfinder folder already included in the CLT. You need to rename config.php to config.bak and then rename !config.php to config.php. That should be all that is required! We ourselves have had issues with CKFinder! If you have problems, try clearing the browsers cache!

Bug & Errors

If you find a bug or error message please let us know! If we cannot replicate the error on the CLT we will need temporary login name and password to access the CLT to see what is causing the error.

Customization

We would be happy to customize your licensed copy of CLT but this is something we will need to charge you for. Just send us a message and we’ll be happy to help.

Video Help

I have created several videos about our CraigsList Listing Tool (these are the same videos listed throughout the documentation.)


Install & Configuration Part 1


Configuration Part 2


How To Create A Listing


Advanced Usage


Viewing Stats (Hit Counts)


Creating A Profile

  • jQuery JavaScript Library
  • CKEditor – Frederico Knabben
  • Image preview – Alen Grakalic
  • jQuery Form Plugin
  • Easy Pinned Footer – J.P. Given
  • ColorBox – Jack Moore
  • PHPMailer – Andy Prevost
  • Form validation – Cedric Dugas
  • jqTransform – mathieu vilaplana
  • Icons – IconFinder
  • SimpleImage – Simon Jarvis
  • htmLawed – Santosh Patnaik

If you are unable to solve the issue buy the above reading; feel free to e-mail me at the link provided above. If I cannot verify you have purchased this script I cannot help you.


Once again, thank you so much for purchasing this CraigsList Listing Tool script. As I said at the beginning, I’d be glad to help you if you have any questions relating to this CraigsList Listing Tool script. No guarantees, but I’ll do my best to assist.

CodeFusion

Update from 1.00/1.01/1.02 to 1.03 – This will not affect your current listings!

This update only applies to people who downloaded the CraigsList Listing Tool prior to 2/XX/2011. You will need to update to the latest version by redownloading it from codecanyon.

First Step – or see 1.03 Change Log

Upload clt to server : Download the latest version (1.03) from codecanyon. Decompress the archive. Upload the new clt folder to your server allowing it to overwrite existing files. This will not affect your current listings, however, it will remove any customizations you have done! See Change Log for specific files that have been updated.

Update Notes

No Installation or Database Changes Required : This update will not affect your current listings. There is no need to reinstall the Craigslist Listing Tool.


Update from 1.00/1.01 to 1.02 – This will not affect your listings!

This update only applies to people how downloaded the CraigsList Listing Tool prior to 2/7/2011. You will need to update to the latest version by redownloading it from codecanyon.

First Step – optional

Delete Images folder : Delete the clt/images folder from your server. There where a number of images included that where never used. Copy new images folder to your server.

Second Step – required

Upload clt to server : Download the latest version (1.02) from codecanyon. Decompress the archive. Upload the new clt folder to your server allowing it to overwrite existing files. This will not affect your listings, however, it will remove any customizations you have done!

Update Notes

No Installation or Database Changes Required : This update will not affect your current listings. There is no need to reinstall the Craigslist Listing Tool.


Version 1.03 – Updates

  • Updated : _config.php
  • Updated : _footer.php
  • Updated : _header.php
  •    Added : corners.php
  • Updated : css/style.css
  • Updated : All files in /themes/ folder as well as all sub folders

Version 1.02 – Updates

To many updated files to list!

Version 1.01 – Updates

Updated _config.php – removed “space” from the end of the file which caused header errors.


If you are unable to solve the issue buy the above reading; feel free to e-mail me at the link provided above. If I cannot verify you have purchased this script I cannot help you.


Once again, thank you so much for purchasing this CraigsList Listing Tool script. As I said at the beginning, I’d be glad to help you if you have any questions relating to this CraigsList Listing Tool script. No guarantees, but I’ll do my best to assist.