Configuration
- Introduction
- Main
- Permission
- Category
- Listing
- Search
- Rating/Rev
- Features
- Notify
- Image
- Sharing
- RSS
- SEF URLs
- Captcha
- Admin
- Frequently Asked Questions
Introduction
Configurations in Mosets Tree controls most aspects of how Mosets Tree works. It can be accessed in Mosets Tree's back-end: "Mosets Tree Configuration". Most of the configurations are self explanatory (at least we try to be!), so we will cover some of the important ones here.
As part of Mosets Tree's multi-directory system, many of the configurations here can be overridden in top level categories, giving you the possibility of creating top level categories with completely different configurations.
If you're looking to customize Mosets Tree, you may also find more configurable parameters by editing Mosets Tree's template:
Mosets Tree Templates [your default template]
Main
View access level
View access level allows you to decide who can view your directory or top level category.
Admin e-mail
This is where all the notification e-mails are sent to. You can enter more than one e-mail by separating them with commas.
Adding new listing requires approval
Set Yes if you want all newly submitted listings from front-end to go through approval before it is published. Listings that are pending for approval can be reviewed in Mosets Tree's back-end:
"Mosets Tree Pending Approval Listings"
Number of days to show as new listing
A "New" badge will be shown beside listing's name if it is a recently added listing. This config lets you to configure the number of days you want a listing to be displayed as new listing.
Number of average unique pageviews per day to show as popular listing
A "Popular" badge is shown when a listing has an average hits equal of above the number configured here.
Unique pageviews session (in seconds)
Mosets Tree uses cookies to track if a user has visited a listing details page before, so that multiple visits to the same listings will be counted as only 1 pageview during a session.
By default, this cookie expires after 86400 seconds (24 hours). The time between the user's first visit and the cookie expiration is called a session. If the user visit the same listing after the cookie expires, the visit will be counted as another pageview.
You can disable this by setting 0. Disabling this will increment the pageview everytime a listing page is viewed.
Use WYSIWYG Editor in front-end Description field
By selecting Yes in this parameter will allow you to use HTML tags in description field. Please note that HTML tags will be stripped in summary view and only shown in details view.
Permission
Edit Permission
Permission allows you to control which user group will gain access to certain functions in Mosets Tree.
Managers
By default, only listing owners can edit and delete their listings in front-end. Managers are users who can edit or delete listings in front-end, even when they do not own the listings. This allows you to assign user groups to manage your directory. Check the checkboxes for "Edit listings" and "Delete listings" to choose which user group can manage listings in front-end.
Category
Primary ordering
Primary ordering allows you to set the order of how categories will be appeared in Mosets Tree. If you set the ordering to Custom, you can custom order your categories by clicking the up/down arrow icons in the ordering column of directory page.
Secondary ordering
This parameter decides the second ordering option to follow if two or more categories have the same order in primary ordering.
Type of listings to show in Index
By default, listings displayed in Index page are those had assigned to the current category. You can this by showing other types of listings in Index, for example, displaying the Top Rated listings or Popular listings.
Scrolling down the Index page, you can see all listings shown are Top Rated listings.
Number of listings in index
Set the number of top listings to be shown in index view. If you set the type of listing to show in index to "Default", the number of listings shown will be based on "Number of listings per page" setting you have configured in Listing tab.
Display categories
If this config is set to No, categories will only be displayed to users in "All Categories" page and no where else.
Display empty category
Empty category means category that contains no sub-categories or listings. By setting Yes to this parameter, all the empty categories will be hidden.
Display 'All Listings' link
This parameter enables 'All Listings' link to be displayed at the top of listing list. "All Listings" displays all the listings that belong to the category, including sub-categories' listing.
Display Filters
Filters lets you to perform a filter on a list of listings. This is available when you view a category through "All Listings". Setting this to No will remove the filter function.
Listing
Data entered to a field is displayed in two places in Mosets Tree front-end, Summary view and Details view.
Listing details view access level
Choose who are authorized to access listings in details view. Unauthorized parties can only view listings in summary view.
Default sorting in All Listings
This config lets you choose the default sorting when your users to view "All Listings" page.
Once users enter this page, they will see the most recent listings first because sorting is set to "Recently Added". Mosets Tree provides several options to let you decide how you want your listings to be displayed to users.
Default secondary sorting in All Listings
This config lets you choose the secondary sorting in "All Listings" page. The default is set to "None".
All Listings page sort options
Sort options allows you to select which "Sort by" options are available in "All Listings" page.
Show user profile in Listing Details page
Setting this to Yes will show the owner's profile in listing details page.
In this listing page, you can see user profile is displayed under listing details. Clicking the user name will direct you to view details of the user profile including user's listings, reviews and favoured listings.
Show Previous/Next listing link
Show 2 links in listing details view to allow your users to navigate to adjacent (previous or next) listing within a category.
This only works well when you order your listings on a column where all your listings have unique values. For example, this works best when you order your listings by 'Name'.
This does not work well when your category are ordered by column where some listings have no value or share the same value. For example, you can not use this feature when you order your listings by Featured or Random.
Additional characters for Alpha Index
By default, Mosets Tree displays Alpha Index in alphabetic and numeric characters for your users to select. This config allows you to add additional characters to the end of the alpha list as part of the selection.
Allow listings submission in root
If you allow listings submission in root, your users will be able to submit listings through Index page.
Show 'Add Listing' link
Configure when to show the 'Add your listing here' link in front-end.
Never: The link will never be shown. Select this if you don't intend to allow users to register and submit listings.
All the time: The link will be shown all the time, unless a category has explicitly set not to allow listing submission. Select this if you want to encourage your users to submit listings to your directory.
Only when user has permission: The link will only be shown when a user has permission to do so and the category allows listing submission.
Allow changing of category in Add Listing
Set this parameter to Yes to allow changing of category when users add listings. Otherwise, listing added will be assigned to the category from where your users click the "Add your listing here" link.
Allow user to assign more than one category to listing
Sometimes, your users may have a listing which is related to multiple categories. You can set this to Yes to let you user assign more than one category. Your users can assign more than one category to a listing when clicking "Also appear in this category" link.
Be sure to also set Yes to "Allow user to assign more than one category to listing" in order to use this.
"Also appear in these categories" is displayed in listing details to show all the categories which a listing is assigned to.
Max. number of assignable secondary categories
This config lets you limit the maximum number of categories which a listing can be assigned to.
Max. number of listings per user
Set the maximum number of listings a user can have in the directory. This includes all published, unpublished and unapproved listings. When your users reached a limit, they will not be able to submit additional listing. Setting this to 0, will disable the limit.
Display listings in root
Set whether to display listings in Index page. Setting this to No will not show any listings in Index page.
Take note that if you set any of your category to use index template page ("Use Main Index template page" is set to Yes), it will follow this config to decide whether to show listings in the index page.
Required fields to mark listing as updated
By default, any updates to a listing causes the listing to be marked as updated with a new modified date. This option allows you to enter the ID of one or more fields (separated by comma) that must be changed before a listing is marked as updated. You can get the field's ID from the ID column in Mosets Tree back-end "Custom Fields" interface.
Number of listings per page
This config lets you set the maximum number of listings to be displayed in one page.
In this page, we have set "Number of listings per page" to 20 and thus you can see at most 20 listings is shown for each page. Click on the page navigation link to view other listings in subsequent pages.
Number of new listings per page
This parameter control the number of new listings per page that will be displayed in "Recently Added" page.
Total new listings
You can set the total number of recently added listings to be displayed in "Recently Added" page.
Number of days to expire listing
Specify the number of days for a listing to remain published upon submission. Once this number of days has passed, the listing will be published down and not visible in front-end. Enter 0 to disable this feature. This config is useful for setting up a classified-like directories.
Search
Mosets Tree has three types of searching functions to help your user find the listings in your directory: Simple Search, Advanced Search and Filters Search. Filter Search is displayed in "All Listing" page which has been explained earlier.
Simple Search
Simple Search is provided by Mosets Tree's Search module and consist of a single text input field. When users search through this module, the search keyword will be matched against fields that are marked as Simple Searchable.
Primary ordering
Primary ordering controls the ordering of the tags search and simple search results through the search module.
Secondary ordering
Secondary ordering works if two or more search results have the same order in primary ordering.
Minimum & Maximum characters
Specify the required minimum and the maximum number of characters allowed when your user search through simple search. When you user enter less than the required minimum or more than the allowed maximum number of characters, they will be shown a message and retry their search.
Advanced Search
Advanced search appears in its own dedicated page. This page is accessible through a link in Search module. Advanced search allow users to locate listings with specific criteria.
Default sorting in results page
This config allows you to choose how listings in advanced search results are ordered.
Filter Search
Show keyword search
Enabling keyword search will show a text input filter in category page's filter form. This allows your users to enter a keyword and search against all simple searchable fields. This is in addition to other custom fields you've made as filter searchable.
Rating/Rev
Rating
Show rating
Setting this to Yes enables users to rate listings.
In this page, you can see rating is placed under listing's description to allow users to rate listing.
"Show Rating" in Properties category has been set to
No, thus rating section is not displayed in front-end.
User can only rate once
By default, users are only allowed to rate once for every listing. If you set this to No, your users will be able to rate your listings multiple times.
Prevent user from rating own listing
You can also prevent the listing's owners to rate their own listings by setting this to Yes.
By signing in to Mosets Tree's demo page as Demo User, you can see from the user profile, this listing is belongs to the logged in user, thus rating on own listing is not allowed if "Prevent user from rating own listing" is set to
Yes.
Minimum number of votes to be considered for top rated listings
To be fair in the calculation for showing top rated listings, you can set a requirement for the minimum number of votes for a listing get before it can be considered for inclusion in the top rated listing list.
This avoids the common problem where a new listing who has just receive a single 5-stars rating are shown above other listings in top rated list, who has been in the directory longer.
Minimum number of votes to show rating
Sets the minimum number of votes a listing must gets before their rating are shown in front-end. This helps maintain fairness in the directory to other listings who has been in the directory longer.
Review
Show review
Setting this to Yes will show all listing's reviews in listings details page.
Scrolling down the page, you will see several reviews from users regarding this listing.
Allow rating during review
If you set this parameter to Yes, a select list will be provided to your users in "Submit review" page for them to submit rating along with their review for a listing.
Require rating during review
Enable Require rating during review will make the rating field a mandatory field in "Submit review" page. In this case, users have to enter a rating before they can submit their review.
Adding new review requires approval
Mosets Tree lets you examine the appropriateness of a new review before it is published in front-end interface. Users will be notify that their review is sent for approval whenever they submit a new review. If require approval is disable, new reviews will be posted directly to the listing without requiring approval.
Prevent user from reviewing own listing
Set this parameter to Yes so the listing's owners won't be able to submit reviews for their own listings.
By signing in to Mosets Tree's demo page as Demo User, go to My Page and simply choose a listing which belongs to the logged in user, for example "Frozen" from Movie category. Try to submit review for this listing so you will be directed to the page to notify you reviewing on own listing is not allowed .
Primary ordering
Ordering lets you decide which review you want to be displayed first in listings details page. For instance, you can show the reviews according to their total number of helpful votes or by review date.
Allow owner to reply reviews
By setting this to Yes, listing's owners are allowed to reply the reviews which is shown in their listings.
Replying to review requires approval
Similar to others Require Approval function, setting this to Yes so you can moderate the owner's reply towards a review before it is published in front-end.
User can only review once
If you choose Yes for this config, you can limit users to submit only one review per listing.
Allow registered user to vote on helpful reviews
You can display helpful votes section on each review for registered users. This allows them to provide feedback to reviews by clicking on Yes or No link to indicate a review's helpfulness.
Pre-defined e-mails to reviewer
Mosets Tree allows you to create up to 5 pre-defined e-mails that you can choose to be sent to reviewer after an approval or rejection of a review. This helps you to respond to any common rejection reason for reviews or just say thanks upon an approval of a review.
Pre-defined replies
You are able to enter up to 5 pre-defined e-mail replies. Every pre-defined reply you entered will become the option of the selection list in Mosets Tree back-end review's pending approval interface. If you checked the "Send e-mail to reviewer upon approval/rejection" checkbox, this selection list will be appeared and allowed you to choose a pre-defined e-mail reply to be sent along with the approval or rejection of a review.
Features
Features allows you to configure most of the functions in the listing page of your directory.
Show map
Mosets Tree comes with support for Google Maps in listings details page which showed a marker on the listing's address. Setting this to No will disable this feature.
Default Country, State & City
If your users does not enter a country, state or city to a listing when they click to "Locate listing in map", the default value set in this config will be used for the geocoding process.
This is useful when your directory is catered only to a specific location.
Show link to map
Enable this feature to provide users a link to view the listing's location in Google Maps.
Show Favourite
This shows "Add as Favourite" link on listings details page for readers to favourite a listing.
Show print
Shows a "Print" button that allows users to print a listing along with the listing details.
Show visit
Shows a "Visit" button where users can visit a listing's website (if provided by listing's owner).
Show claim
Shows a "Claim" button to allow users to claim listings as their own. When users claiming a listings, a pending approval notification will be sent to Administrator. Administrator can view this claim in Mosets Tree's back-end to approve or reject the claim.
Show owner's listings
Shows a "Owner's listings" link will provide a link for other readers to view all the owner's listings.
Default owner's listings
Each users on your site will have a user profile page that show all their listings, reviews and favoured listings. This config lets you choose which tab (either Listings, Favourites or Reviews) is to be shown first when one enters a user profile.
Show contact
"Contact" link allows users to contact the listing's owner by sending an e-mail to them through a contact form.
E-mails that are sent through this contact form are sent to the e-mail address entered in the listing's E-mail field. If this field is empty and Use user's e-mail address if listing e-mail is empty config is set to Yes, the e-mail will be sent to the owner of the listing.
Display contact form in
Contact form will be shown in a dedicated page if you select to display contact form in Standalone Page. Otherwise you can select to display contact form in Listing Details Page so your users can see the contact form by scrolling down the page.
Contact BCC E-mail
All e-mails that are sent through the contact form will be BCC-ed to the email address(es) provided in this field. If you have more than one BCC e-mail address, separate them by commas.
Show report
"Report" link allows users or public to send a report message to Administrator for a listing that may be offensive, has inaccurate information or contain any other appropriate reasons, for reporting.
Show recommend
If your users find a great listing, this "Recommend" link will let them to recommend that listing to their friends through e-mail.
Use user's e-mail address if listing e-mail is empty
Any messages related to the listing will be sent to the listing's owner through the e-mail address provided during submission of the listing. Otherwise, messages will be sent to the e-mail address of the user's account.
Notify
Notify allows you to configure when to send a notification e-mail to Admin and Listing's owner.
Admin
For Admin, you can configure if notification e-mails will be sent when the following event occurs:
- New listing
- Modify listing
- Delete listing
- New review
Owner
While for Listing's owner, you can configure if notification e-mails will be sent when the following event occurs:
- New listing
- Modify listing
- Listing approved
- Review approved
- Review added to own listing
Image
When an image is uploaded, system will save the image in three formats: the original image, thumbnail sized image and medium sized image.
Note: Changing the value for image sizes or squared thumbnail feature will not change the images you already uploaded to your listings. To apply the new configuration to your existing image, you need to rebuild your images using the Rebuild Thumbnails tool. This tool will rebuild your listings' small & medium images by resizing them based on the configuration you have.
You can access the tool at:
Mosets Tree Tools Rebuild Thumbnails
Small/Thumbnail's image size
This allows you to set the maximum width and height of a thumbnail image.
Squared thumbnail
Setting this to Yes will generate thumbnails with a square dimension. This will produce a consistent set of thumbnails with same dimension in the directory. However for some images, the sides of the thumbnail could be cropped out in order to fit in to a square.
Medium's image size
This is the maximum width and height of a medium sized image.
Minimum image width in pixels
You can set the minimum image width in pixels required for users to upload a medium sized image.
Minimum image height in pixels
This parameter controls the minimum image height required for users to upload a medium sized image.
Category's image size
This is the maximum width and height of a category image.
Allow owner to upload image
Setting this to Yes allows listing's owner to upload images when adding or editing a listing.
Images per listing
Images per listing lets you set the maximum number of images can be uploaded to a listing.
Sharing
In sharing, you can control whether to insert social bookmarking buttons in listings details view so that users can share your directory pages in popular social networks such as Facebook, Twitter, Pinterest, Google+ and LinkedIn.
Facebook Like
By setting this to Yes, Facebook Like will show the like button on every listings details page.
Pinterest On Hover Pin
On Hover Pin will show Pinterest's Pin it button on your listing's main image when a user mouses over it.
Twitter Card
Mosets Tree supports Twitter Cards that helps your user to tweet with richer media experience.
Use Twitter Card
When a listing contains at least one image, Twitter Card will attach the image when your users share or tweet the listings.
Site Twitter
Enter site's Twitter username without the @ sign. This will be used in content attribution when users share listings to Twitter.
Twitter Card Type
Select one of these values: summary, summary_large_image or photo. To check out more about Twitter Card Types, click here.
If you're using summary_large_image or photo card type, be sure to allow Twitter crawler to access your photos. Mosets Tree's listings' photos are located at /media/com_mtree directory and Joomla's robots.txt file by default prevents any crawler to access /media directory.
To lift this restriction, edit your site's robots.txt file and remove the following Disallow line:
Disallow: /media/For more information, refer to Twitter's Getting Started Guide for Cards.
RSS
Mosets Tree generates an RSS Feed for all categories' recently added and recently updated page. This is often useful when you want to let users know of changes in your directory without needing them to check your website constantly through use of RSS feed readers or news aggregator.
The RSS's feed icon can be seen next to the "Recently Added Listings" title. You can also see this in Recently Updated page.
Mosets Tree RSS contains your listing names, descriptions, URLs and images. Options in Configuration's RSS tab allows you to add additional elements to your RSS feeds. The additional element will look like this:
<mtree:cust_1>value</mtree>where "cust_1" will be replaced by the custom field name and "value" is the value of the field for a listing. The caption and and the field's value will also be shown as part of the feed item's description.
SEF URLs
Enable Search engine friendly (SEF) URLs to provide an easier way to access to your directory pages by using a succinct URLs in your directory. It also helps with Search Engine Optimization (SEO) by having relevant names and keywords in your URLs.
To enable Mosets Tree' SEF URLs, turn on Joomla Search Engine Friendly URLs in Joomla's Configuration (Go to "System Global Configuration", under SEO Settings) and Mosets Tree will generate SEF URLs for your directory.
Listing's slug type
You can control how to represent listing in SEF URL.
Alias
When a listing or category is added to Mosets Tree, an alias is created based on their names. This is typically done by lowercasing the name and replace all spacing with dash. Choosing "Alias" slug type will use this for your listing slug. eg:
http://www.example.com/directory/business/acme-incLink ID
Instead of using an alias, "Link ID" will use the listing ID as the listing slug. eg:
http://www.example.com/directory/business/119Link ID & Alias Hybrid
"Link ID & Alias Hybrid" slug type uses both alias and listing ID for your listing's slug. This gives the best of both world. Using link ID guarantees that each of your listing have unique URL and using alias gives each listing a human friendly URL.
Captcha
You can decide which feature you want to use a Captcha to verify your site's visitors are real human and not a robot.
Admin
This section lets you control some aspect of Mosets Tree's back-end interface.
Use Explorer
By setting this to Yes, you can see the explorer that contain your site's directory in tree-like form on the left hand side of the interface.
Explorer's Tree Level
By default, Mosets Tree limits the depth of your Explorer's Tree to prevent it from loading too many categories at once. You can change the value here to increase or decrease the level of categories you want to show in your Explorer.
Use Internal Notes
Mosets Tree allows you to write down notes for each listings and most items that are pending approval. This is useful when you are collaborating with multiple editors that manage your directory. You can turn this feature off by setting it to No.
Use WYSIWYG Editor description field in back-end
Set this to Yes if you want to use WYSIWYG Editor in your core description field.
Frequently Asked Questions
You can manage all the reviews from your directory through Mosets Tree's back-end. Under the Listings section, you will see a "Reviews" column which shows the total number of reviews for each listing in hyperlink. Click on the link to manage reviews for a particular listing.
Show Report under the Feature tab is used for reporting a listing, not a review. To disable "Report" link in reviews, you can configure it under Permission. Go to:
Mosets Tree Configurations Edit Permissions... (under "Main" tab)
set the permission for Report Review to "Denied".