Build your Model Agency Portal in WordPress
Minimal Requirements:
Quick installation with WordPress already installed:
Cpanel screens:
2. Upload devon_theme.zip on server via cpanel file manager to folder "wp-content/themes"
3. Activate theme in your WordPress admin dashboard:
4. Install theme, plugins and demo content:
Plugin support custom register/login page, users registered there will automatically become agents/own.
Visitors can also quick submit listings even without registration proccess, but if user is not registered account will be automatically created (require only email).
For other account types by default quick submission is disabled, but you can enable user type transformation for subscriber in Admin->Listings->Settings
Custom register page can be defined in:
Quick submission
In Admin->Listings->Settings you can define Quick submission page
This page can be used for quick submission (require to populate only required fields and defined fields by administrator). Visitors can submit listings even without registration proccess, but if user is not registered account will be automatically created (require only email).
You can add this page link into your menu if you wish.
You can also add nice quick submission button widget to sidebar, example:
Example of usage:
Admin/Agent/Regular submission
In Admin (Dashboard)->Listings admins/agents can add llistings:
Our Theme support many templates for specific usage, like profile, results, listing preview, content, contact, news.
With default demo installation everything will be configured nicely and you can check yourself in admin.
Example usage:
Templates are build based on WordPress standard widgets, this can be edited in widgets editor or customizer in WordPress, and primary visual builder elementor elements example:
Plugin support categories, and based on categories you can define visible fields
This visible fields dependent on categories will have effect on listing submission and search form
To enable this feature go to Admin->Listings->Settings->Check "Show categories"->Save
In Admin->Listings->Settings you can also check "Search in sub-categories", this means that when searching, results from subcategories also will be visible in results
You can manage categories in Admin->Listings->Categories
When edit category, you can manage visible fields:
Map pin icons
Map pin icons are also related to categories, example:
Automatic locations
Plugin support automatic locations based on user populated fields like address, country, city, and auto search based on this data with help from google api to detect coordinates.
Search example with google api suggestions, and after that detect coordinates:
Manual strict locations
You can also additionaly add manual strict locations like Country->City->Neighbourhood
To enable this feature go to Admin->Listings->Settings->Check "Show locations"->Save
Then in Admin->Listings->Locations add location tree like example:
You can also add multiple values at once, example:
Location search field can be also added in Admin->Locations->Search form
Now you can select location on listing submission form
After that if you don't want to use custom Country or CIty field you can remove them
SVG Region Map
You can also automatically build locations based on SVG map data, example:
Guide to add amcharts SVG maps: http://listing-themes.com/nexos-wp/docs/img/desc2/svg_map_wp.pdf
Complete plugin is organized based on Fields, so listing details are collected from fields.
You can manage this fields (Drag & drop) to reorder, edit, delete in Admin->Listings->Fields
Some fields are RED LOCKED, this means that we doesn't allow to remove them. We doesn't allow this because field is importand by design/functionality for web or for mobile api. But in any case you can rename it suggesting for some similar purpose.
Please don't change/remove category fields type, Fields not in categories are not visible automatically on listing preview, only specific defined field like description or content are visible, so don't remove/change all categories!
If you want to customize listing preview HTML, related file:
wp-content/themes/devon/SW_Win_Classified/views/frontend/listingpreview.php
Example modification in WordPress dashboard, to add new field above description in listing preview:
In this example 87 is new field ID, found in admin->listings->fields
Search form is designed as widget or VIsual Composer element. Every search result also must content primary search form to work properly.
When user first click on search form it's redirected to results page ( defined in Admin->Listings->Settings )
Search form contains listing fields, and can be visually generated in Admin->Listings->Search form
For some searching based on numbers from/to you need to make fields searchable and all new added listing will be searchable by this field, example, when edit non-searchable field:
You can also transform INPUTBOX/INTEGER into dropdown on search form, in some cases like Price selection.
Example solution:
Results page ( defined in Admin->Listings->Settings ) containe result items
Result item contain listing fields, and can be visually generated in Admin->Listings->Result item
If you want some HTML changes on result item or result page its located in:
wp-content\themes\devon\SW_Win_Classified\views\frontend\resultspage.php
Regular plugin version is located in, but template version have priority if you using template related:
wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend\resultspage.php
If you want to customize infowindow on map then file:
wp-content\themes\devon\SW_Win_Classified\views\frontend\infowindow.php
Regular plugin version is located in, but template version have priority if you using template related:
wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend\infowindow.php
In WordPress you can change langauge here:
Admin->Settings->General->Site Language
For translations we suggest Loco Translate plugin
Localization files can be found in: wp-content\plugins\SW_Win_Classified\locale
Elementor Blocks for DEVON
and for theme: wp-content\themes\devon\locale
If some words missing there, try to sync template file, guide:
Video GIF example for sync first template and after that language file (so 2 times for theme and plugin):
First template file must be synced + saved
Then also language file synced + saved
Also some fields are dynamically generated, like search form, submission fields and similar, this can be translated in: Admin->Listings->Fields->Edit all and change name, values
Categories for example in Admin->Listings-Categories
Locations for example in Admin->Listings-Locations
TRANSLATION SHARING:
If you translate theme into your langauge, will be nice if you can share it with us, to share it please zip folders:
wp-content\themes\devon\locale
wp-content\plugins\SW_Win_Classified\locale
and send it to: support@geniuscript.com
thank you very much!
Our plugin also support commercial WPML if you will need it, WPML require additional page for each langauge.
1. Buy and Download CMS version here: https://wpml.org/
2. Install WPML in usual regular way (default order of languages, because in our plugin first language in order is also default) and add new pages for each langauge and page:
3. You should add language switcher widget
4. To translate regular translation words use Loco Translate plugin as described in previous section, WPML also support some additional tools:
5. Translate fields:
6. Translate categories
7. Translate listings
8. Some translate settings
Multilanguage required - In dashboard required fields must be populated for all languages
If Multilanguage required will be unchecked, then fields will be copied or auto translated
You can provide Google Translate API key (not free) for best Google translations, in other case MyMemory free api will be used.
Instructions to get API key: https://cloud.google.com/translate/v2/getting_started
Limit cURL calls is there because some servers doesn't allow unlimited calls for translations (each input field translation require one call), here can be limited and other translations will be just copied.
On quick submission user need to populate only default language
As any other WordPress plugin or theme, our also contain lot of Widgets which can be added to some predefined places in specific template
Usually it's right sidebar or footer. For example search form fit nicely right sidebat, map results listing footer etc.
In Admin->Appearance->Widgets you can drag & drop existing widgets (prefixed with SW) to such predefined places in your template
Our theme support standard widget placeholders, some are default or based on template used
As any other WordPress plugin, our also contain lot of Shortcodes which can be added to pages
Shortcodes example
[swlisting id="xx"]
Single listing based on listing id "xx", listing id is numeric value and can be found in Admin->Listings, column #
[swlistings text_criteria="xx" show_featured="xx" num_listings="xx" agent_id="xx"]
Multiple listings with filter options
text_criteria can be any text for search, example "luxury"
show_featured can be ALSO_FEATURED or ONLY_FEATURED or ONLY_FEATURED
num_listings is number of listings limitation
agent_id can be user ID or user email
[swagent id="xx"]
Single agent based on user ID "xx", or user email
[swagents text_criteria="" num_listings="xx"]
Multiple agents with filter options
text_criteria can be any text for search, example "luxury"
num_listings is number of listings limitation
[swmap address="xx" content="xx"]
Show map with pin on specific address and with specific content on infowindow
[swmaplistings text_criteria="xx" num_listings="xx" agent_id="xx"]
Multiple listings with filter options, visible on map
text_criteria can be any text for search, example "luxury"
num_listings is number of listings limitation
agent_id can be user ID or user email
[swfeaturedlistings]
Show featured listings only
[swcontact email="xx"]
Show contact form
[swprimarysearch] - Show primary search form
[swsecondarysearch] - Show secondary search form
Special content feature
[swcontent] - This code will be replaced with plugin content if available in text
Facebook login
You should create app in facebook for facebook login functionality:
Create app by this guide: http://iwinter.com.hr/support/?p=552
Then enter parameters in Admin->Listings->Settings
Google reCaptcha SPAM prevention
Get your recaptcha keys on page: https://www.google.com/recaptcha
Then enter parameters in Admin->Listings->Settings
You can export all users email in Admin->Tools->MailChimp, this can be used in mailchimp and also some another apps to import and build newslatter campaign
Related to templates:
For demo purposes we using Twenty Sixteen and Total, but tested also with:
Twenty Seventeen,Twenty Sixteen,Twenty Fifteen,Twenty Fourteen and Total
CSS, theme related:
If you want something very special, you can add own css changes, this require basic css knowledge.
You can use firefox or chrome developer console, in firefox can be oopened with CTRL+SHIFT+K
then locate what you want to change
and add custom css into standard WordPress customizer, example:
CSS, plugin related:
If you need to customize some styles, change it in:
wp-content\plugins\SW_Win_Classified\assets\css\style.css
Or even better in your theme custom css file.
For some CSS customizations we suggesting to use Firefox and Developer Tools (CTRL+Shift+K)
PHP related:
Our plugin is based on Codeigniter MVC arhitecture and Bootstrap on frontend.
https://www.codeigniter.com/user_guide/
MVC means:
M = Models (generate database queries)
V = View, contains mostly HTML
C = Controller contains mostly logic, transfer data from M to V
How to detect in which file is something:
We organized WordPress URL in this way, when url looks like:
wp-admin/admin.php?page=listing_manage
This means listing is controller in admin, and manage is method in this controller
Controller code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Listing.php
View (HTML) code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\admin\listing\manage.php
When we using URL like this:
wp-admin/admin.php?page=currency_manage&function=addcurrency&id=32
This means currency is controller in admin, and addcurrency is method called in this controller
Controller code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Currency.php
View (HTML) code can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\admin\currency\addcurrency.php
Dashboard menus:
It's defined in file: sw_win_options.php
Widget controller:
wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Widgets.php
Widget name represents controller method
Widget views (HTML):
Can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\widgets
Shortcode controller:
wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\Shortcodes.php
Shortcode name represents controller method
Shortcode views (HTML):
Can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\shortcodes
Custom pages defined in Admin->Listings->Settings:
Controller is: wp-content\plugins\SW_Win_Classified\codeigniter\application\controllers\frontend.php
Views can be found in: wp-content\plugins\SW_Win_Classified\codeigniter\application\views\frontend
(This is related to VIsual Listings plugin only)
From v1.4 plugin we implemented advance theme support.
Please reading custom coding section before that.
So you can add custom HTML for all view files based on your theme requirements.
Structure is same as in plugin folder, but here it's located in theme folder, example:
Additionaly we added some custom functions support for themes like demo installation.
By default this functions are implemented in file:
wp-content\plugins\SW_Win_Classified\codeigniter\application\models\Install_m.php
Example how we run this function:
You can define this functions in functions.php template file or similar where you saving such functions usually.
Example functions, we suggesting custom install.php file for such functions:
We have special website made for support, frequency questions for customizations, guides for basic CSS/HTML, tips & tricks etc.: http://iwinter.com.hr/support
Regarding hosting providers, we testing on:
How to change homepage?
Admin->settings->reading
PDF export doesn't work?
You should not have website locked with password, PDF export doesn't work then
WordPress.com issues with install demo content on premium account:
WordPress.com doesn’t allow you to upload your own themes (you’re stuck with what’s available for free or in their marketplace) so in order to use any of the awesome themes on marketplace you’ll need to get yourself a self-hosted installation of WordPress.
We will try to make as most features possible compatible, but they have so many limitations for plugins that is not suggested to use it.
Use cheap and good hosting suggested in above section instead.
Installation failed with message: The package could not be installed. The theme is missing the style.css stylesheet. ?
You using wrong file for theme installation, open this file, maybe you have inside devon_theme.zip , use this devon_theme.zip file instead.
Link has expired message in WordPress?
Check this articles:
https://superpctricks.com/the-link-you-followed-has-expired-wordpress-error/
https://docs.presscustomizr.com/article/333-how-to-fix-the-link-you-followed-has-expired-in-wordpress
So this usually happen because of small upload_max_size configuration on server and is easy to solve. You can also extract theme directly on server cpanel file manager into folder "wp-content\themes\" instead of uploading via dashboard.
This sometimes happen in WordPress, not relate to theme, Clear your browser cache and cookies or use another browser / PC.
Also use clean latest WordPress version, because some third parity plugins can also cause that.
You receiving "Sorry you are not allowed to access this page" ?
Check above, similar to link has expired.
Also check your PHP version, must be min. 5.6 or above
How to import data to plugin/theme?
Plugin "Wp all import" can be used for import any csv or xml file, with nice visual fields mapping. If you need cronjob support you can purchase pro version but for basic imports it's free. http://www.wpallimport.com/
You need to download and activate it from wp plugin repository, Admin->Plugins->Add New
You also need to install and activate our plugin Winter Listings WpAllImport
After that follow standard wpallimport proceddure, example for start:
Multiple categories can be inserted this way:
How to export data?
Plugin "Wp all export" can be used for export any csv or xml file, with nice visual fields mapping.
http://www.wpallimport.com/export/
Guide to use:
You need to download and activate it from wp plugin repository, Admin->Plugins->Add New
You also need to install and activate our plugin Winter Listings WpAllImport
After that you need to prepare listings for export, screen:
After that you can export as usual with wp all exports
You want to enable page offline?
You can use any plugin for this purpose, like: https://wordpress.org/plugins/site-offline/
How to change currency?
Admin->Listings->Fields->Edit price for example and change prefix/suffix
In Admin->Currencies you can also change it on currency conversion widgets
Google maps stop working?
We added open street maps support as alternative and can be activated in Admin->Listings->Settings
Google maps become commercial, paid services and actually not cheap,
All details available here: http://iwinter.com.hr/support/?p=17200
Basically Admin->Listings->Settings and enter your own google maps api key
You add listing but it's not available on page?
Listing must be activated by admin or paid services to become visible.
Admin->Listings->Edit wanted->check if it's activated
You want to disable word Any in search forms?
Some coding required, example:
Similar way yo ucan customize any other field.
Receiving error, Call to undefined function get_header() in index.php... ?
You don't have WordPress installed. This is WordPress theme so WordPress is required for installation.
function get_header is part of WordPress and if you don't have it installed so is expected that will be undefined.
All details about that function: https://codex.wordpress.org/Function_Reference/get_header
Solution 1:
1. Install WordPress by some regular WordPress installation guides.
2. Install this WordPress theme by docs guide.
After changes on website you still see old website version on mobile or desktop and happens even after clearing browser cache?
Server caching causing this.
You need to contact your hosting provider or server admin to disable server caching, also WordPress plugins for caching can cause this, sometimes hosting provider add that for you to reduce server usage, specially on cheap reseller or shared accounts.
Example cache detection with console: https://prnt.sc/kf12x5
Some links examples and solutions:
https://support.wptouch.com/article/1466-endurance-page-cache
https://github.com/bluehost/endurance-page-cache/issues/15
https://github.com/bluehost/endurance-page-cache/issues/27
Issue with sending emails?
Some servers have trouble with that and you need to use SMTP feature.
We tested this one and works fine with our plugins: https://wordpress.org/plugins/wp-mail-smtp/
Translated fields not visible?
You must translate also categories where this fields belong, if category is not translated, then all fields inside this category will not be visible.
Follow complete translation guide, please don't skip steps.
Your field width on submission to small or want to change?
You have issue like this?
Solution based on bootstrap columns/grid system:
if you want based on category or location you can use in text criteria: location_id_1 or category_id_1 where 1 is ID number example
How to disable report listing or some other feature?
Some features are added as plugins so you basically need to deactivate plugin, example:
And some in WordPress customizer widget or settings, so check in Customizer
I receiving message when adding listing "The Title field cannot exceed 20 characters in length. (English)" ?
admin->listings->fields->edit title and change max length to wanted
I've used the following files and services as listed:
Thank you so much for purchasing this template. We will do our best to help you if you have any questions or issue relating to this plugin.