Wilcity Translation Helper is a plugin that helps you can translate config.translation.php easier.
In order to translate config.translation.php before, You will have to download this file from wilcity theme, translate it and upload the translation file to wilcity-childtheme -> configs.folder.
With Wilcity Translation Helper plugin, you can use Loco to translate this file.
How can I setup this feature?
Before setting up this feature, make sure that you are using the latest version of Wilcity and Wilcity Plugins.
Wilcity Service is a useful plugin of Wilcity, it allows customers can easily upgrade Wilcity, Wilcity Plugins from old version to new version with 1 click. Since Wilcity 1.1 gets stronger, We added Installation feature to this tool, which means when an extension of Wilcity is being released, You don’t have to Download and then Upload it manually anymore, You just need to go to Wilcity Service -> Click Install button on plugin that you want to use.
Wilcity Advanced Search is an extension of Wilcity theme. This plugin helps to can easily search fields and define Search Results.
Installation
Step 1: Setting up Wilcity Service
In order to install this plugin, please make sure that Wilcity Service is setup on your site, You can click here to know how to do it.
Warning: Make sure that You are using Wilcity Service 1.1 or higher version.
Step 2: Installing Plugin
Log into your site
Click on Wilcity Service from the admin sidebar
Click on Install button on Wilcity Advanced Search box
Finally, click Activate button
How Wilcity Advanced Search works?
Step 1: Customizing your Search Engine
Click on Appearance -> Theme Options -> Advanced Search Settings. You can customize your search engine here.
Complex and Top Search Target
What is Complex Search?
Complex Search are search fields that defined under Hero Search Form: Wiloke Tools -> Listing Settings -> Hero Search Form
What is Top Search?
The Top Search is Yellow Field on the Top of Search V2
How does Complex and Top Search works?
As the default, when entering a keyword, it will return 3 type of results:
Geocoder
Listing Location
And Default Search
As the above example, when entering Hanoi, I will get 3 type of results.
Geocoder:
If We select Geocoder, Wilcity will determine Hanoi Geocoder (Latitude and Longitude). Imaging that We have a Circle and the center is Hanoi Geocoder, the Circle Radius is your setting under Appearance -> Theme Options -> Search Settings -> Default Radius.
So, all Listings within this Circle will be selected:
So, how can We setup Listing in this circle? It’s Google Address setting under each Listing: Listings -> Your Listing
Listing Location:
It’s your Listing Location category. If We select Listing Location result, all listings that are Children of this location will be returned
Default Search:
They are Listings that have Title and Content are matched the keyword.
Now, Take a look at the Wilcity Advanced Search setting:
You can add more type of results to the Complex and Top Search Field.
Note that if you are using Custom Post Type UI to add more categories to your site, You can add those categories to Search Results as well.
Number of Listings, Number of Terms and Number of Geocoder:
It allows You can specify maximum of results for each Result Type.
Default Search Search By:
As the default, WP Default Search will search by Title and Content. This feature will allow you to improve its query.
Lunar New Year Holiday is as known as Tet Holiday in our country. Lunar New Year – Jan 25th, 2020 is the traditional Vietnamese New Year and the most valuable holiday in Vietnamese culture is now around the corner. Wilcity would like to express our appreciation for your strong support and trust as well as your continuous cooperation.
Please be informed that our Customer Support service will behave a bit delay and behind
from Friday, Jan 24th to the end of Wed, Jan 27th
The business operation will resume as normal on Thursday, Jan 28th, 2020. Our operation is not going to stop during this time, only the Customer Service has a delay in processing your issues.
So that should you have any questions, please do not hesitate to submit a ticket to https://wilcity.ticksy.com/tickets/, We will try to check your ticket regularly and try our best to solve your issue if they are urgent situation.
We apologize for any inconvenience
I wish you and your family good health, success, and happiness in the new year.
Wilcity 1.2.0 introduced Search Form V2 with better UX. In this tutorial, I will explain to you how it works and how can you setup it.
There are 4 parts in the Search Form:
Top Search Field
Post Types Navigation
Filter Items
And Search Results (Listings)
Top Search Field
The Top Search Field has highest position on the Search page. When a customer enters a keyword into this field, Wilcity will fetch to Google / Mapbox address, Listing Location and Listings.
If Google / Mapbox is matched keyword, it will return a list of Address Suggestion. Each of suggestion contains 3 information: Address, Latitude and Longitude. If one of these values is selected, Search by Radius will be processed. Imaging that We have a Circle, the Latitude and Longitude of the selected address is Center of this circle, and Wilcity will return all Listings that has Latitude and Longitude within this circle.
So how can You provide Latitude and Longitude to each Listing: Click on Listings -> Your Listing -> Google Address Setting.
To specify Radius to this Circle, click on Appearance -> Theme Options -> Search Setting.
If Listing Locations are matched keyword, a list of Listing Locations will be returned. If one of them is selected, Wilcity will show up all Listings belong to this Listing Location (the query parameter will combine with Search Filter Items as well). If the selected Location is a parent location, Wilcity will get all its Listing Location Children and append to Region Search Field (If it’s available)
If Listing Title / Listing Content is matched keyword, a list of Listings will be returned. When clicking on one of them, Browser will redirect to this Listing directly.
Post Types Navigation
In Wilcity, each Post Type has its Search Fields. To setup Search Field Items, click on Wiloke Tools -> [Your Listing Type] Settings -> Main Search Form.
The Post Type helps to Navigation Search Fields. In other words, when clicking on a Post Type, Wilcity will get its Search Fields on show on the Search Form.
To setup Post Type, click on Wiloke Tools -> Add Directory Type
Search Fields
The following search fields WILL NOT show up on Search Form V2: What are you Looking for ? and Where to Look?. However, you should add it to Used Fields area still. Why? It’s needed if you are using Wilcity App.
We recommend using New Price Range instead Price Range (Only use this field if you still want to use Search Form V1)
Custom Search Field: It’s very easy to add a Custom Field to Search Form V2.
Setting up Search Form V2
Go to Pages -> Add New -> Enter in the Page Title -> Set this page to Wilcity Search V2 template
Click Publish button
Go to Appearance -> Theme Options -> Search Settings -> Assign this page to Search Page setting
Hoping this tutorial helps you understand how Search Form V2 works. Thence, You can setup a Search Fields for your site.
Wilcity 1.2 comes with power of New Search Page. Like the previous versions, You can easily drag a Search Field to Search Form area, and it resolved the disadvantage of this previous as well: Custom Field can be added to Search Form area now.
Besides, Search Without Map and Search With Map have been merged into 1 page instead of separating to 2 different pages like previous versions.
In this version, We added a new field Complex Search. It’s combination of Where to looks? field, Where are looking for? and Region field in the previous versions. In short, when entering a keyword on this field, it will return maximum 3 types of result: Single Listing, Listing Location and Google Address.
If the customer clicks on:
Single Listing: Browser redirects to this Single Listing directly
Listing Location: Browser redirects to Search Page and search by Listing Location
Google Address: Browser redirects to Search Page and search for all Listings within X KM
So when using Complex Search field, We should not use Where to looks field and Region field.
Wilcity 1.2.0 also auto remove Hero Tab Item if there is 1 Listing only.
3. Wilcity Listings Tabs
Wilcity Listings Tabs is get more stronger now. You can add a relation between Listing Category and Listing Location to this feature and add more filter Options to Listings Tabs Panel. To learn more about Wilcity Listings Tabs, please read How to setup Wilcity Listings Tabs
4. Tracking Review From the Front-end Dashboard
The listing owner now can track reviews on his/her listing from the admin dashboard. They can also hide / review a review on the dashboard as well.
5. Wilcity Term Groups Shortcode
Since Wilcity 1.2.0, You can add a Relation Between Listing Location and Listing Category to Rectangle Term Boxes, Term Boxes and Modern Term Boxes shortcode. When clicking on a Term box, browser redirects to Search Page and search for all Listings belongs to Location and Category that you picked up.
It’s new shortcode in Wilcity 1.2.0, the shortcode allows displaying All Listing Types on the Home page. when clicking on a Listing Type, the Browser redirects to Search Page and all Listings belongs to this Listing Type will be shown up.
7. Repeated group
Wilcity 1.2 allows you can enable repeated group feature in Group Field setting. You can also use Uploader feature in the group as well.
8. WYSIWYG to Listing Content field
Your customers now can use WYSIWYG editor on Add Listing page.
9. Business Hours
With Wilcity 1.2.0, You can now set Open 24hrs to a day in a week. You can also setup Overnight Business Hour as well.
EG: If you have a Bar Listing, You can setup Open at 7 AM, and Close at 3 AM (next day)
All existing users should create a Staging Site and upload the new version on it first – please read https://themeisle.com/blog/wordpress-staging-site/ to learn how to create a Staging site. We added lots of features to this version, so it may conflict with a third-party plugin and your custom code, the Staging site is a safe solution for your business.
Step 2: Building Custom Taxonomy page with Wilcity Shortcodes
Wilcity New Grid shortcode
Since Wilcity 1.2.0, Wilcity New Grid was added. This shortcode works like Wilcity Listings Tabs, but it does not have Tabs Filter.
Let’s have a look at its settings:
Heading: If you want to use a dynamic Heading, You can put %termName% in it. In the above example, when visiting Hanoi Location, the Heading is Food experiences in Hanoi and when visiting New York, it’s Food experiences in New York.
Description: You can use %termName% in the description as well
Taxonomy Type: We have setting up Listing Location, so We SHOULD NOT set Taxonomy type to Listing Location type.
Select Listing Location: We SHOULD leave it empty. When the field is empty, the current Listing Location is filled up.
So, when visiting Hanoi Location, the shortcode will display all listings that belong to Listing Categories that were specified in the shortcode and Hanoi Location.
Maximum Items: We recommend leaving it empty. When leaving this setting empty, the number of items is matched Items / Device setting
When using this group shortcodes in a Term page, We recommend paying to Taxonomy Type setting:
If you set Taxonomy Type to Listing Location, You should leave Select Listing Locations empty. The Children of Listing Locations will be filled up automatically.
If you set Taxonomy Type to Listing Category, You should Selection Listing Location empty and specify Categories that you want to use to Select Listing Categories setting.
The Listing Location is became a Dynamic Location, which means Wilcity will automatically filled up Current Location to this field.
The above example, when clicking on Shopping -> Browser will redirect to Search Page -> and the Search page will show up Listings that belong to Shopping category in New York city.
Wilcity Post Types (It’s available since Wilcity 1.2)
In WordPress, The item in Tag, Category, Listing Location, Listing Category is called Term. EG: We add New York to Listing Location. New York is called Term
Wilcity provides various shortcodes (Term Boxes, Rectangle Term Boxes, Modern Term Boxes, Masonry Term Boxes) that allow you can show up Terms on the Front-page. These shortcodes have the same functionality but different from styles, We call them Terms Group.
In this tutorial, We will use Rectangle Term Boxes to explain Terms Group feature.
Setting up Rectangle Term Boxes shortcode
Step 1: Click on Pages -> Your Front page
Step 2: Click on Add New shortcode
Step 3: Search for Rectangle Term Boxes and insert this shortcode to Editor
Understanding Rectangle Term Boxes shortcode settings
Term Redirect:
There are 2 options Self Term Page and Search Page.
Self Term Page: Which means when clicking on a Term, the browser will redirect to its page. To setup the Term page, please read #placeholderhere#
Search Page: Instead of redirecting to self Term page, it will redirect to Search page. To setup Search Page, please read and follow Setting up Search Page
Taxonomy Type
Specifying what taxonomy will be used on the shortcode.
If Taxonomy Type is Listing Location, Select Listing Locations will be shown up. And If Taxonomy Type is Listing Category, Select Listing Categories will be shown up.
Select Listing Location / Listing Category
This feature was not added from original, It’s available from Wilcity 1.2.0.
So, Why did we decide to add this feature? Let me explain it:
Imaging that We have a group of Listing R in New York City and these listings belong to Restaurant Category.
We have a group of Listing H in New York City and these Listings belongs to Hotel Category.
This feature helps to split Restaurant Category and Hotel category to 2 different Term Boxes.
The above example, When clicking New York, it will redirect to Search page and it will show up all Listings that belongs to Restaurant category in New York city
Wilcity Listings Tabs allows you can create Multiple Grids (The Listing Locations/Categories are tab items and each grid layout is under a Listing Location / Listing Category tab) on the Home Page and You can also add Filter Options to Grid, so Customers can Filter Listings that meets their purpose right on the Home Page instead of going to Search Page.
Setting up Listings Tabs
Step 1: From the admin sidebar, click on Pages -> Your Front – Page -> Click on Add New Shortcode
Step 2: Search for Listings Tabs -> Click on it
Step 3: You will see Listings Tabs setting now, You should pay attention to the following settings:
Navigation Type: Which means what Taxonomy You want to set as Navigation Filter (In WordPress, Listing Category, Listing Location are called Taxonomies)
Get Terms Type: There are 2 options Specify Terms and Get Term Children (The item in Listing Location / Category is called Term).
1. Specify Terms means all terms that are selected in Select Listing Categories / Locations setting will be used as Navigation Items.
Get Terms Type example
2. Get Term Children means We will get the children of Term that is selected in Select Listing Categories / Locations. EG: We setup Albany, Chemung, Chenango, Rensselaer, Westchester are children of New York Location, and New York is set to Select Listing Locations on Listings Tabs shortcode, the Albany, Chemung, Chenango, Rensselaer, Westchester will be shown up as Navigation Items
Order By Options: This feature allow customers can Filter Listing right on the Listings Tabs
Select Listing Location / Select Category: When Navigation Type is set to Listing Location, this setting will show up as Listing Category and vice versa. In the previous version, We didn’t add this feature, but Why We added it now? Let us explain its purpose:
Imaging that you have 3 Locations: New York, Paris, Hanoi and 3 Categories: Food, Hotel, Shopping.
And now, We set Listing Category as Navigation Type => The front-end will display ALL Listings that belong to Food, Hotel and Shopping.
If a customer who wants to Paris next week, will he interesting in Listings in New York and Hanoi? No, he won’t!
So, We will set Paris to Listing Location => The front-end will display All Listings that belongs to Food, Hotel, Shopping in Paris now.
Maximum Items: Maximum listings are shown up on each Listings Grid. We HIGHTLY RECOMMEND LEAVING EMPTY this setting. When leaving it empty, Wilcity will AUTOMATICALLY calculate maximum listings on each devices.
To understand this feature, please click on Column Settings tab.
So, when leaving empty Maximum Items, Maximum Listings on the screen that has 1200px are 5 listings, 960px are 4 listings.
