Step1: Download & Install Pro Version
Step2: Configuration
Step 3: Category
Step 4: Locations
Step 5: Custom Fields
Step 6: Payment History
Step 7: Pricing [Store Addon]
Step 8: Membership/ Store Enable [Store Addon]
Step 9: Import/ Export
Step 10) Front End Submission
Step 11: Front end Listings
Step 12: My Account
- My listings
- Store
- Favourites
- Payments
- Account Details
Step 13: Developer Guide
Step: 14: Import Demo Content
Step 15: Shortcodes
Step 16: Enable Account Creation
Step 17: Enable Social Login
Step 18: Enable WooCommerce Payment
Step 19: Enable Chat Feature
Step 20: Category Menu Link
Step 20: Developer Docs
Step 1: First download from your purchase email link or login site then go to purchase history
Step 2: Configuration
General Settings
2.1.1) Bootstrap options: Classified Listing use Bootstrap 4 if your theme has Bootstrap 4 included then uncheck this option.
2.1.2) Include Result: If you want search result include child categories & locations then check this option.
2.1.3) Listing Per Page: Set how many you want to display per page.
2.1.4) Related Listing: Set how many related listing you want to display.
2.1.5) Set default listing view List/ Grid , Default order by: Date posting / Title/ .. Sort by:
2.1.6) Category/ Location: Set order by and sort by
2.1.7) Location Settings: We have 3 level of location set the level State, City & Town.
2.1.8) Currency Options: Set your currency and currency symbol etc..
2.2.1) Listing Duration: Set Listing duration ex: 30 days after 30 days listing will be unpublished then it will be deleted.
2.2.2) New Listing Threshold: How many days a listing mark as New
2.2.3) New Listings Level: Set New Listing Lavel
2.2.4) Popular Listing threshold (View count): When listing will be popular based on view count.
2.2.5) Popular Listing Level: Set popular listing Label.
2.2.6) Featured Listing Label: Set Featured listing Label.
2.2.7) Top Listing Label: Set Top listing Label.
2.2.8) Enable Top Listing top of list: Check if you want to enable top listing top of page & set how many want to display.
2.2.9) List view fields control: Check/ Uncheck which fields you want to display or not in list view.
2.2.10) Detail view fields control: Check/ Uncheck which fields you want to display or not in Detail view.
2.2.11) Report abuse: Check if you want to enable report abuse option.
2.2.12) Add to Favorites: Check to enable add to Favorite option.
2.2.13) Enable Map: Check to enable map.
2.2.14) Contact Form: Check to enable contact form.
2.2.15) Comment form: Check to enable comment form.
2.2.16) Max image per listing: Set how many image can upload per listing.
2.2.17) Delete expire Listing: Set after expire how many days listing will be deleted.
2.2.18) New Listing status: Set New listing status.
2.2.19) Listing status after Edit: Set listing status after edit.
2.3) Settings => Payment
2.3.1) Enable Payment: If you want to make your customer want to pay you for listing then enable this settings.
2.3.2) Currency option: Please select the currency you want to use.
2.3.3) We have 4 types of payment configure the payment gateway.
2.4) Settings => Email
2.4.1) Admin Notification: Check which notification admin want to get his email.
2.4.2) User Notification: Check which notification user get his email.
2.4.3) Email Sender option: Set From name & From Email.
2.4.4) Admin Notification email: Set admin notification email.
2.4.5) Email Template: You can use this email template tag in the page template.
2.4.6) Click to see the template view.
2.4.7) Email Content Type: Set content type HTML, Plain or Multipart.
2.4.8) Header image: Set your logo.
2.4.9) Footer Text: Set email footer text.
2.4.10) Color: You can set email base color, background color, body color & body text color.
Email Templates
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingSubmittedEmailToOwner.php
Listing Submitted email (confirmation)
2.4.11) You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingSubmittedEmailToOwner.php
Like this way, you can override all email template. You can also translate the file using WPML or polylang plugin.
2.4.12) Subject & Heading: You can change Subject and Header from here.
Listing Published/ Approved Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingSubmittedEmailToOwner.php
2.4.13) Subject & Heading: You can change Subject and Header from here.
Listing Renewal Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/OrderCompletedEmailToCustomer.php
2.4.14) Subject & Heading: Set Listing Renewal email thresholder day. Also you can change Subject and Header from here.
Listing Expire Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingExpiredEmailToOwner.php
2.4.15) Subject & Heading: You can change Subject and Header from here.
Listing Reminder Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingRenewalEmailToOwner.php
2.4.16) Subject & Heading: Set Listing reminder email in day. You can change Subject and Header from here.
Listing New Order Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/OrderCompletedEmailToCustomer.php
2.4.17) Subject & Heading: You can change Subject and Header from here.
Listing Order Completed Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/OrderCompletedEmailToCustomer.php
2.4.18) Subject & Heading: You can change Subject and Header from here.
Listing Contact Email
You need to override email template like move plugins/classified-listing/app/Emails folder to your theme folder like your-theme/classified-listing/emails/ListingContactEmailToOwner.php
2.4.19) Subject & Heading: You can change Subject and Header from here.
5) Settings => Account & Policy
1) Account Creation: Check enable account createion (Make sure Enable User Registration from WordPress Settings also)
2) New User Default Role: You can set default WordPress settings or set own settings
3) Allow Custom Role: Check to allow others role to post ads
4) Allow post for unregister user: Check this box so unregister user can post ads (An auto account will create with his email address)
5) User Verification: Check this to verify user via Email accress.
6) Social Login: You can use custom shortcode using 3rd party plugin to enable social login.
7) Terms & Condition: Enable Terms & condition and set the terms and condition page.
8) Privacy Plocy: Set privacy policy page and others text.
2.6) Settings => Style
2.6.1) Set Primary color link color, link hover color, button color, button hover color etc…
2.6.2) Set Top Label background color, text color, Feature text color, background color, popular text color and background color.
2.2.7) Settings => Misc
2.7.1) Image Sizes: Set gallery image size, thumb image size, store banner & store logo.
2.7.2) Allow Image Type: Set allow image size PNG/ JPG/ JPEG
2.7.3) Allow Image size: set max image size.
2.7.4) Check user can edit image.
2.7.5) Social Share: Check the social share & which page show the share buttons.
2.7.6) Set Google Map Api key to show map.
2.7.7) Set ReCaptcha Settings like site key & Secrete key.
2.2.8) Settings => Advanced
2.8.1) Listing & Store Page slug= Set the listing detail page and store page slug. After change this settings you need to reset permalink,
2.8.2) Set Listing Page, Listing form page, my account and Checkout Page.
2.8.3) Set others page endpoint url slug.
2.8.4) Checkout Page Endpoint: Set checkout pages endpoint slugs
Step 3) Category
- Category name = Add category name
- Select Parent category if any.
- Add category description.
- Order => You can manually set category order.
- Type: Set category type like Sell , Buy, Exchange & Job
Step 4: Locations
You can add location one by one or we have Location import option in JSON format please follw the syntex download from Github
Step 5) Custom Fields
You can create unlimited custom Fields
We have 7 Types of custom fields
- Text Box
- Text Area
- URL
- Number
- Date with range
- Select
- Radio
- Checkbox
You can create custom field as group then set it for category wise or specific category.
Custom fields you can set for listing view also for left size filtering.
Step 6 ) Payment History
After payment done you can see the list from here.
Step 7 ) Pricing
We have two types of pricing option Regular price & Membership payment [Store addon].
Regular: Regular price for individual item payment like for top ads or featured ads you can set price and how many days ad will active.
Membership: [Store addon]
Membership price if for Package like no of ads for no of days. You can set this option for all categories or specific category access.
Step 8: Membership/ Store Enable [Store addon separate item]
8.1) Enable Membership: If you check enable membership then membership option will enable in you site.
8.2) Store: If enable store then members can open store.
8.3) Free ads: Check if you want member can post some free ads.
8.4) Number of Free ads: set the numbers here.
8.5) Renew free ads: Set number of days when free ads will renew.
8.6) Allow Category: If you want set free ads for specific category or full site.
You can see the available store [Store addon]
Step 9) Import / Export :
We have demo data and category with custom fields as demo you can import that. Download the file format from Github
Step 10: Front end Submission
First you need to login / register then go to submit listing
Form1: Submission for has 2 steps first select ad type then parent category then subcategory then this form auto go to next step
Form 2: Now fill the fields one by one
- If you want to change the category then click change
- Add Title
- Price Type
- Enter price
- Custom fields will display here.
- Enter ads description
- Upload images you can change how many image you allow and image max size.
- Contact Detail: from account settings you can set your location and hone no then no need to enter again.
Step11: Front end Listing
Step 12: My account
12.1) My listing => You can see all of yours ads here can promote/ Edit / Delete also.
12.2) Store => You can add your store settings here like store Banner, Logo, Opening time, contact info etc… [Store addon]
12.3) Favourites => User can see there favourites ads from here can delete also.
12.4) Payment => User can see his payment history from here.
12.5) Account detail => User can edit there account info from here. Can set location, phone no & address info so it auto fill in the listing submission form
13) Developer Guide
Template Override
Step 12: Import demo data
First go to Tools => Import (Install WordPress Installer Plugin)
Download the same data from here then unzip Click to Download
Now select file classified-listing.xml then click Import it will take some time to import all demo data with categories, custom fields, Location and some demo posts.
Shortcode:
==>For my account Page use:
[rtcl_my_account]
==>For Checkout Page use:
[rtcl_checkout]
=> Listing Submit Page
[rtcl_listing_form]
==>For Category wise display use different parameters you can use as you need:
[rtcl_listings category=’1,3,4′ location=’2,3,4′ orderby=”wp_query wordpress supported” order=’ASC/DES’ listings_per_page=20 listing_top_per_page=4]
==>For Listing display use this shortcode different parameters use as your need:
[rtcl_categories view=’list’ orderby=’id/count/name/slug/term_group/custom’ order=’ASC/DES’ columns=’4′ description=0/1, show_count=0/1, icon=0/1, image=0/1, hide_empty=0/1, pad_counts=0/1, equal_height=0/1]
==>For Filter listing use this shortcode different parameters use as your need:
[rtcl_filter_listings location=’2,3,4′, category=’3,5,6′, related_listings=0, type=’all’, limit=8, orderby=’wp_query wordpress supported’ order=’ASC/DES’, view=’grid/list’, columns=4, show_image=0/1, image_position=’top’, show_category=0/1, show_location=0/1, show_labels=0/1, show_price=0/1, show_date=0/1, show_user=0/1 show_views=1/0, pagination=0]
Step 16: You need to enable from two settings first WordPress main settings then plugin settings see below:
1) First need to allow user registration from WordPress => Settings
2) Then allow account creation from Classified Listings Plugin Settings => Account & Policy
You can use any social login plugin from wordpress.org then use that plugin shortcode into Settings => Account & Policy
https://wordpress.org/plugins/miniorange-login-openid/
https://wordpress.org/plugins/oa-social-login/
Step 18: WooCommerce Payment Gateway Setup
First Install and Setup WooCommerce make sure setup WooCommerce completly so checkout and others WooCommerce default page created then set the WooCommerce payment.
Go to Classified Listing Plugin Settings => Payment => WooCommerce Payment
- Check to Enable WooCommerce Payment.
- See all Enabled WooCommerce Payment are listing below.
Step 19: Go to Settings => chat
- Chat => Enable chat check this box to enable chat in ads detail page.
- Unread Message => Enable to send mail to unread message
Some server database table structure sometimes chat data don’t save and show in dashboard.
In this case follow the instruction.
1=>Ok go to your PHPMyAdmin backend and remove this two table
wp_rtcl_conversations
wp_rtcl_conversation_messages
2=> Deactive classified listing plugin
3=> Reactive the classified listing plugin
Make Category Link with Menu
We use archive page as like WooCommerce so you can make menu link with custom URL. Go to Classified Listing admin menu then Category mouse hover on category you will get view option click on that then you will get front end view get the URL and make menu link with custom url.
Developer Documentation
How to Change Currency Symble
Write this code in function.php
rt_rtcl_get_currency_symbols_cb($symbols) {
$symbols['LKR'] = 'RS';
return $symbols;
}
add_filter('rtcl_get_currency_symbols', 'rt_rtcl_get_currency_symbols_cb');
How to Remove Price Type
add_filter( 'rtcl_price_types', function($price_types){
unset($price_types['on_call']);
return $price_types;
} );
How to make Store time 24 hrs format
function rtcl_store_time_options_rt_cb($data){
$data['showMeridian'] = false;
return $data;
}
add_filter('rtcl_store_time_options', 'rtcl_store_time_options_rt_cb');